Serper

🚀 使用 Serper 搜索的模型上下文協議服務器

本項目是一個提供 Google 搜索通過 Serper 的 Model Context Protocol 服務器。藉助此服務器，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": "<您的 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 密鑰>"
               }
           }
       }
   }
   

💻 使用示例

基礎用法

在配置好 MCP 服務器後，就可以在代碼中使用 google_search 工具進行搜索。以下是一個簡單的示例，展示如何使用該工具：

# 假設這裡有調用 google_search 的代碼
# 由於原文檔未提供具體代碼，這裡僅作示意
result = google_search(q="example query")
print(result)

🔧 調試

您可以使用 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 許可證。