serper

🚀 使用 Serper 搜索的模型上下文协议服务器

这是一个基于 Model Context Protocol 的服务器，借助 Serper 实现 Google 搜索功能。该服务器能让大语言模型（LLM）获取 Google 的搜索结果信息。

🚀 快速开始

此服务器提供了便捷的使用方式，你可以根据自己的需求选择合适的安装方法。

使用 uv（推荐）

1. 确保已在您的操作系统中安装了 uv。
2. 在您的 MCP 客户端代码配置文件或 Claude 设置（文件 claude_desktop_config.json）中添加 serper MCP 服务器：

   {
       "mcpServers": {
           "serper": {
               "command": "uvx",
               "args": ["serper-mcp-server"],
               "env": {
                   "SERPER_API_KEY": "<您的 Serper API 密钥>"
               }
           }
       }
   }
   

   uv 将会自动从 pypi.org 下载 MCP 服务器，并应用到您的 MCP 客户端。

使用 pip 项目

1. 在您的 MCP 客户端代码的 requirements.txt 文件中添加 serper-mcp-server：

   serper-mcp-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 为您的客户端添加配置：

   {
       "mcpServers": {
           "serper": {
               "command": "python3",
               "args": ["-m", "serper_mcp_server"],
               "env": {
                   "SERPER_API_KEY": "<您的 Serper API 密钥>"
               }
           }
       }
   }
   

使用 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": "<您的 Serper API 密钥>"
               }
           }
       }
   }
   

✨ 主要特性

可用工具

• 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）

🔧 调试

您可以使用 MCP 检查工具来调试服务器。

• 对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx serper-mcp-server

• 或者如果您已安装该包在特定目录或正在开发中：

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

📄 许可证

serper-mcp-server 采用 MIT 许可证。