Serper (Google Search)

🚀 Serper MCP 服务器

Serper MCP 服务器是一个提供 Google 搜索 via Serper 的模型上下文协议 (MCP) 服务器。它能让大型语言模型 (LLM) 获取 Google 的搜索结果信息，为语言模型的应用拓展了更多可能。

✨ 主要特性

• 提供 google_search 工具，可获取 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": "<Your Serper API key>"
            }
        }
    }
}

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": "<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>"
            }
        }
    }
}

💻 使用示例

可用工具

• 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/your/directory
npm install -g @modelcontextprotocol/inspector
@modelcontextprotocol/inspector uvx serper-mcp-server

📄 注意事项

⚠️ 重要提示

请确保您已经获取了有效的 Serper API 密钥，并按照文档正确设置环境变量。