Skip to main content

A MCP server for Serper

Project description

Serper MCP Server

PyPI version PyPI Downloads Monthly Downloads Python Version

A Model Context Protocol server that provides Google Search via Serper. This server enables LLMs to get search result information from Google.

Available Tools

Usage

Installing via Smithery

To install Serper MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @garylab/serper-mcp-server --client claude

Using uv (recommended)

  1. Make sure you had installed uv on your os system.

  2. In your MCP client code configuration or Claude settings (file claude_desktop_config.json) add serper mcp server:

    {
        "mcpServers": {
            "serper": {
                "command": "uvx",
                "args": ["serper-mcp-server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

    uv will download mcp server automatically using uvx from pypi.org and apply to your MCP client.

Using pip for project

  1. Add serper-mcp-server to your MCP client code requirements.txt file.

    serper-mcp-server
    
  2. Install the dependencies.

    pip install -r requirements.txt
    
  3. Add the configuration for you client:

    {
        "mcpServers": {
            "serper": {
                "command": "python3",
                "args": ["-m", "serper_mcp_server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

Using pip for globally usage

  1. Make sure the pip or pip3 is in your os system.

    pip install serper-mcp-server
    # or
    pip3 install serper-mcp-server
    
  2. MCP client code configuration or Claude settings, add serper mcp server:

    {
        "mcpServers": {
            "serper": {
                "command": "python3",
                "args": ["serper-mcp-server"],
                "env": {
                    "SERPER_API_KEY": "<Your Serper API key>"
                }
            }
        }
    }
    

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx serper-mcp-server

Or if you've installed the package in a specific directory or are developing on it:

git clone https://github.com/garylab/serper-mcp-server.git
cd serper-mcp-server
npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<the key>

License

serper-mcp-server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_garylab_serper_mcp_server-0.0.10.post1.tar.gz.

File metadata

  • Download URL: iflow_mcp_garylab_serper_mcp_server-0.0.10.post1.tar.gz
  • Upload date:
  • Size: 45.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_garylab_serper_mcp_server-0.0.10.post1.tar.gz
Algorithm Hash digest
SHA256 5bc1e28afab0a4b6376d6faa1babacec1e2b6eca66b67bcdc18f870ffaafc3bb
MD5 8c383aab8f91fc9ef5c31fc4e5fc2e38
BLAKE2b-256 da67206ea621db9aaf61b57c4e7f72e1e7dfd9bb8e5f0f1cf2c77338a4071352

See more details on using hashes here.

File details

Details for the file iflow_mcp_garylab_serper_mcp_server-0.0.10.post1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_garylab_serper_mcp_server-0.0.10.post1-py3-none-any.whl
  • Upload date:
  • Size: 7.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_garylab_serper_mcp_server-0.0.10.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 05e70bd72f2401afcb753242ab66f19c746be21929259f4af3f4a8cf998f54cc
MD5 4b068bb5e0bcb56f5da5d13dad4d5c6d
BLAKE2b-256 6f51d06842126c42d99011393a8b03221884262e289aecd71293e999d1fc0dd6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page