Serper

What is Serper MCP Server?

Serper MCP Server is a Model Context Protocol (MCP) server designed to facilitate Google searches for Large Language Models (LLMs). It leverages the Serper API to provide LLMs with access to various Google search functionalities, enabling them to retrieve up-to-date information directly from Google search results.

How to use Serper MCP Server?

Serper MCP Server can be installed and used in several ways:

• Installing via Smithery: For automatic installation with Claude Desktop, use the Smithery CLI command: npx -y @smithery/cli install @garylab/serper-mcp-server --client claude.

• Using uv (recommended): Ensure uv is installed. Add the Serper MCP server configuration to your MCP client code or Claude settings (claude_desktop_config.json), including your SERPER_API_KEY.

• Using pip for project: Add serper-mcp-server to your requirements.txt, install dependencies (pip install -r requirements.txt), and then configure your client with the appropriate command and SERPER_API_KEY.

• Using pip for globally usage: Install globally via pip install serper-mcp-server (or pip3), then configure your MCP client or Claude settings with the server command and SERPER_API_KEY.

Key Features of Serper MCP Server

Serper MCP Server offers a comprehensive suite of Google search tools:

• google_search: General Google search.
• google_search_images: Search for images.
• google_search_videos: Search for videos.
• google_search_places: Search for places.
• google_search_maps: Search on Google Maps.
• google_search_reviews: Search for reviews.
• google_search_news: Search for news.
• google_search_shopping: Search for shopping results.
• google_search_lens: Utilize Google Lens for visual search.
• google_search_scholar: Search for academic papers.
• google_search_parents: (Specific functionality not detailed, likely related to parental controls or family-oriented search).
• google_search_autocomplete: Get search autocomplete suggestions.
• webpage_scrape: Scrape content from webpages.

Use Cases of Serper MCP Server

• Enhancing LLM capabilities: Provide LLMs with real-time access to Google search results, allowing them to answer questions, generate content, and perform tasks that require up-to-date information.
• Building intelligent agents: Develop AI agents that can perform various search-related tasks, such as gathering information, researching topics, and analyzing trends.
• Data retrieval for applications: Integrate Google search functionality into custom applications to retrieve specific data points, images, videos, or news articles.
• Content generation and summarization: Enable LLMs to pull information from the web to generate more accurate and comprehensive content or summaries.

FAQ about Serper MCP Server

Q: What is the Model Context Protocol (MCP)? A: The Model Context Protocol is a framework that allows language models to interact with external tools and services, extending their capabilities beyond their pre-trained knowledge.

Q: Do I need a Serper API key to use this server? A: Yes, a Serper API key is required to use the Serper MCP Server, as it relies on the Serper API for Google search functionalities.

Q: How can I debug the Serper MCP Server? A: You can debug the server using the MCP inspector. For uvx installations, use npx @modelcontextprotocol/inspector uvx serper-mcp-server. If installed in a specific directory, navigate to that directory and use npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<the key>.

Q: What is the license for Serper MCP Server? A: Serper MCP Server is licensed under the MIT License, allowing for free use, modification, and distribution under its terms and conditions.

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.