Google Custom Search

🚀 使用谷歌自定義搜索的MCP服務器

這是一個提供網頁搜索功能的模型上下文協議（MCP）服務器，藉助谷歌自定義搜索API和網頁內容提取功能，助力用戶高效開展網頁搜索與內容提取工作。

🚀 快速開始

獲取谷歌API密鑰和搜索引擎ID

1. 創建谷歌雲項目：
   • 訪問谷歌雲控制檯。
   • 創建新項目或選擇現有項目。
   • 開啟項目計費。
2. 啟用自定義搜索API：
   • 訪問API庫。
   • 搜索“Custom Search API”。
   • 點擊“啟用”。
3. 獲取API密鑰：
   • 訪問憑證。
   • 點擊“創建憑證”>“API密鑰”。
   • 複製你的API密鑰。
   • （可選）限制該密鑰僅用於自定義搜索API。
4. 創建自定義搜索引擎：
   • 訪問可編程搜索引擎。
   • 輸入要搜索的站點（使用www.google.com進行全網搜索）。
   • 點擊“創建”。
   • 在下一步中點擊“自定義”。
   • 在設置中啟用“搜索整個網絡”。
   • 複製你的搜索引擎ID(cx)。

✨ 主要特性

搜索工具

• 運用谷歌自定義搜索API執行網頁搜索，可搜索整個網絡或特定站點。
• 能夠控制結果數量（範圍為1 - 10）。
• 獲取結構化結果，涵蓋標題、鏈接和摘錄。

網頁閱讀器工具

• 提取任何網頁內容，抓取並解析網頁內容。
• 提取頁面標題和正文文本。
• 清理內容以去除腳本和樣式。
• 返回結構化數據，包含標題、文本和URL。

📦 安裝指南

通過Smithery安裝

要自動通過Smithery安裝適用於Claude桌面的谷歌自定義搜索服務器，可執行以下命令：

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

與Claude桌面一起使用時，添加包含你的谷歌API憑證的服務器配置：

• 在MacOS中：~/Library/Application Support/Claude/claude_desktop_config.json
• 在Windows中：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

💻 使用示例

搜索工具

{
  "name": "search",
  "arguments": {
    "query": "你的搜索查詢",
    "num": 5 // 可選，默認為5，範圍1-10
  }
}

網頁閱讀器工具

{
  "name": "extract",
  "arguments": {
    "url": "網頁鏈接"
  }
}

示例響應

搜索工具

{
  "items": [
    {
      "title": "結果標題1",
      "link": "https://example.com/1",
      "snippet": "結果摘錄1"
    },
    // 其他結果...
  ]
}

網頁閱讀器工具

{
  "title": "頁面標題",
  "text": "頁面正文內容..."
}

🔧 技術細節

開發

• 安裝依賴：

npm install

• 構建服務器：

npm run build

• 開發時自動重建：

npm run watch

調試

使用DEBUG=mcp-google-search環境變量啟用調試輸出：

DEBUG=mcp-google-search npm start

📄 許可證

文檔未提供相關許可證信息。

⚠️ 重要提示

• 確保你擁有搜索目標站點的權限。
• 遵守谷歌API的服務條款和使用限制。