Serper MCP 服务器

一个提供通过 Serper 进行 Google 搜索的模型上下文协议服务器。此服务器使 LLM 能够从 Google 获取搜索结果信息。

可用工具

• google_search - 获取搜索结果。
  • 必需参数：
    • q (字符串): 要搜索的查询
  • 可选参数：
    • gl (字符串): 要搜索的国家/地区，例如 us, uk, ca, au 等。
    • location (字符串): 要搜索的地点，例如 San Francisco, CA, USA
    • 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
   # 或
   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 安装：

npx @modelcontextprotocol/inspector uvx serper-mcp-server

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

cd path/to/servers/src/serper
npx @modelcontextprotocol/inspector uv run serper-mcp-server

许可证

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