A Model Context Protocol server that provides Google Search via Serper. This server enables LLMs to get search result information from Google.
google_search
- Get the result of the search.- Required arguments:
q
(string): The query to search for
- Optional arguments:
gl
(string): The country to search in, e.g. us, uk, ca, au, etc.location
(string): The location to search in, e.g. San Francisco, CA, USAhl
(string): The language to search in, e.g. en, es, fr, de, etc.tbs
(string): The time period to search in, e.g. d, w, m, ynum
(integer): The number of results to return, max is 100 (default: 10)page
(integer): The page number to return, first page is 1 (default: 1)
- Required arguments:
-
Make sure you had installed
uv
on your os system. -
In your MCP client code configuration or Claude settings (file
claude_desktop_config.json
) addserper
mcp server:{ "mcpServers": { "serper": { "command": "uvx", "args": ["serper-mcp-server"], "env": { "SERPER_API_KEY": "<Your Serper API key>" } } } }
uv
will download mcp server automatically usinguvx
from pypi.org and apply to your MCP client.
-
Add
serper-mcp-server
to your MCP client coderequirements.txt
file.serper-mcp-server
-
Install the dependencies.
pip install -r requirements.txt
-
Add the configuration for you client:
{ "mcpServers": { "serper": { "command": "python3", "args": ["-m", "serper_mcp_server"], "env": { "SERPER_API_KEY": "<Your Serper API key>" } } } }
-
Make sure the
pip
orpip3
is in your os system.pip install serper-mcp-server # or pip3 install serper-mcp-server
-
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>" } } } }
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
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.