Serper MCP Server

MCP 服务器

通过 Serper 提供 Google 搜索的模型上下文协议 (MCP) 服务器。该服务器使 LLM 能够从 Google 获取搜索结果信息。

可用工具

• google_search - 获取搜索结果。
  • 必需参数：
    • q （字符串）：要搜索的查询
  • 可选参数：
    • gl （字符串）：要搜索的国家/地区，例如美国、英国、加拿大、澳大利亚等。
    • location （字符串）：要搜索的位置，例如美国加利福尼亚州旧金山
    • hl （字符串）：要搜索的语言，例如 en、es、fr、de 等。
    • tbs （字符串）：要搜索的时间段，例如 d、w、m、y
    • num （整数）：返回的结果数，最大值为 100（默认值：10）
    • page （整数）：要返回的页码，第一页为 1（默认值：1）

用法

使用uv （推荐）

1. 确保您已在操作系统上安装了uv 。
2. 在您的 MCP 客户端代码配置或Claude设置（文件claude_desktop_config.json ）中添加serper mcp 服务器：
   { "mcpServers": { "serper": { "command": "uvx", "args": ["serper-mcp-server"], "env": { "SERPER_API_KEY": "<Your Serper API key>" } } } }
   uv将使用uvx从pypi.org自动下载 mcp 服务器并应用到您的 MCP 客户端。

使用pip进行项目

1. 将serper-mcp-server添加到您的 MCP 客户端代码requirements.txt文件中。
   serper-mcp-server
2. 安装依赖项。
   pip install -r requirements.txt
3. 为您的客户端添加配置：
   { "mcpServers": { "serper": { "command": "python3", "args": ["-m", "serper_mcp_server"], "env": { "SERPER_API_KEY": "<Your Serper API key>" } } } }

使用pip进行全局使用

1. 确保pip或pip3在您的操作系统中。
   pip install serper-mcp-server # or pip3 install serper-mcp-server
2. MCP 客户端代码配置或者Claude设置，添加serper mcp 服务器：
   { "mcpServers": { "serper": { "command": "python3", "args": ["serper-mcp-server"], "env": { "SERPER_API_KEY": "<Your Serper API key>" } } } }

调试

您可以使用 MCP 检查器来调试服务器。对于uvx安装：

或者，如果您已将软件包安装在特定目录中或正在其上进行开发：

执照

serper-mcp-server 采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。