mcpField
S
Serper MCP Server

Serper MCP Server

FeaturedLocal
pypi.orgSearch39Updated 50w ago
RepositoryVisit website

About Serper MCP Server

Serper MCP Server is an MCP server that provides Google Search through the Serper API, letting LLMs retrieve Google search results. It offers tools for web, image, video, news, scholarly and patent search, along with webpage scraping.

Key features

  1. 01Web, image and video Google search tools
  2. 02Places, maps and reviews search
  3. 03News, shopping and patent search
  4. 04Google Scholar search
  5. 05Webpage content scraping

Use cases

  1. 01Give an LLM access to live Google search results
  2. 02Retrieve news, scholarly papers or patent information
  3. 03Scrape webpage content from search results

MCP support

The project runs as an MCP server, exposing google_search tools and a webpage_scrape tool to MCP clients.

#mcp#google-search#google-search-api#serper#serperdev#mcp-server#serperapi#google-search-mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "serper": {
      "command": "uvx",
      "args": [
        "serper-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "<SERPER_API_KEY>"
      }
    }
  }
}
Run commanduvx serper-mcp-server
Environment variables to set
SERPER_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiserper-mcp-server

Tools

13

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
glanyNoThe country to search in, e.g. us, uk, ca, au, etc.
hlanyNoThe language to search in, e.g. en, es, fr, de, etc.
locationanyNoThe location to search in, e.g. San Francisco, CA, USA
numintegerNoThe number of results to return, max is 100
pageanyNoThe page number to return, first page is 1
qstringYesThe query to search for
tbsanyNoThe time period to search in, e.g. d, w, m, y

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.