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 密鑰，並按照文檔正確設置環境變量。