What is Serper Mcp Server

serper-mcp-server is a Model Context Protocol server that provides Google Search results via Serper, enabling large language models (LLMs) to retrieve search information from Google.

Use cases

Use cases include enhancing chatbots with real-time information, integrating search capabilities into applications, and providing up-to-date data for research and analysis.

How to use

To use serper-mcp-server, you can either install it using ‘uv’ or add it to your project’s requirements.txt file. For ‘uv’, configure your MCP client with the server command and your Serper API key. For ‘pip’, add ‘serper-mcp-server’ to requirements.txt and install it, then configure your client accordingly.

Key features

Key features include the ability to perform Google searches with customizable parameters such as query, country, location, language, time period, number of results, and pagination.

Where to use

serper-mcp-server can be used in various fields including AI development, data retrieval, and any application that requires real-time access to Google search results.

Serper MCP Server

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

Available Tools

• google_search - Set all the parameters
• google_search_images - Set all the parameters
• google_search_videos - Set all the parameters
• google_search_places - Set all the parameters
• google_search_maps - Set all the parameters
• google_search_reviews - Set all the parameters
• google_search_news - Set all the parameters
• google_search_shopping - Set all the parameters
• google_search_lens - Set all the parameters
• google_search_scholar - Set all the parameters
• google_search_parents - Set all the parameters
• google_search_autocomplete - Set all the parameters
• webpage_scrape - Set all the parameters

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:

cd path/to/servers/src/serper
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.