Google Search MCP

🚀 增強版谷歌搜索MCP服務器

這是一個強大的模型上下文協議（MCP）服務器，藉助先進的匿名化和反檢測功能，提供增強的谷歌搜索能力。

🚀 快速開始

此項目為實驗性項目，請自行承擔使用風險。它是一個使用網頁抓取技術的實驗性谷歌搜索MCP服務器。請注意以下幾點：

• 速率限制：谷歌可能會阻止此服務器的請求或對其進行速率限制。
• 可靠性：由於谷歌的反抓取措施，搜索結果可能不一致。

🔍 推薦替代方案

對於生產環境使用，我們強烈建議使用官方搜索API或成熟的MCP服務器：

• DuckDuckGo MCP服務器：更可靠且符合服務條款的替代方案。
• 必應搜索API：微軟官方的支持MCP集成的搜索API。
• 谷歌自定義搜索API：谷歌官方的搜索API（需要API密鑰）。
• SearXNG MCP：注重隱私的元搜索引擎集成方案。

只有在您瞭解相關風險和限制的情況下，才使用此實驗性服務器。

✨ 主要特性

🔍 增強的搜索能力

• 高級查詢支持：支持處理帶有引號、運算符和過濾器的複雜搜索查詢。
• 可配置的結果：可限制結果數量（1 - 10），設置語言、地區、安全搜索和時間範圍。
• 多種解析策略：具備強大的結果提取能力和後備機制。

🛡️ 高級匿名化

• 逼真的瀏覽器指紋：使用旋轉的用戶代理來模擬真實瀏覽器（Chrome、Firefox、Safari、Edge）。
• 動態請求頭：隨機化Accept - Language、Accept - Encoding和安全請求頭。
• 會話隨機化：使用唯一的會話ID和請求指紋。
• 請求定時：添加隨機延遲以避免被檢測到模式。

🚀 可靠性特性

• 智能重試邏輯：對失敗的請求採用帶抖動的指數退避策略。
• 速率限制處理：自動檢測並優雅地處理速率限制。
• 錯誤恢復：具備全面的錯誤處理機制，並提供用戶友好的錯誤信息。
• 超時管理：可配置超時時間並進行適當的錯誤報告。

🔧 技術改進

• 多個結果選擇器：能適應谷歌不斷變化的HTML結構。
• URL清理：正確處理谷歌的重定向URL。
• 內容驗證：確保所有結果都有有效的URL和內容。
• 全面的日誌記錄：提供詳細的日誌用於調試和監控。

📦 安裝指南

通過Smithery安裝

要通過Smithery為Claude Desktop自動安裝google - search - mcp，請執行以下命令：

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

手動安裝

npm install

💻 使用示例

開發模式

使用交互式CLI在開發模式下啟動服務器：

npm run dev

生產模式

啟動服務器用於生產環境：

npm run start

測試

運行全面的測試套件：

npm run test

在開發過程中進行持續測試：

npm run test:watch

MCP工具：search

服務器提供了一個強大的搜索工具，具有以下參數：

參數

• query（必需）：要執行的搜索查詢。
• limit（可選）：最大結果數量（1 - 10，默認值：5）。
• language（可選）：語言代碼（例如，'en'、'es'、'fr'、'de'、'ja'）。
• region（可選）：地區代碼（例如，'us'、'uk'、'ca'、'au'）。
• safeSearch（可選）：過濾級別（'off'、'moderate'、'strict'）。
• timeRange（可選）：時間過濾器（'hour'、'day'、'week'、'month'、'year'）。

示例用法

{
  "name": "search",
  "arguments": {
    "query": "Model Context Protocol MCP",
    "limit": 5,
    "language": "en",
    "region": "us",
    "safeSearch": "moderate",
    "timeRange": "week"
  }
}

與Claude Desktop配置

將以下配置添加到您的Claude Desktop MCP設置中：

{
  "mcpServers": {
    "enhanced-google-search": {
      "command": "npx",
      "args": ["tsx", "/path/to/your/project/src/server.ts"]
    }
  }
}

📚 詳細文檔

架構

核心組件

1. UserAgentGenerator：創建逼真的瀏覽器指紋。
2. RequestAnonymizer：處理請求的匿名化和定時。
3. SearchParameterBuilder：構建優化的搜索參數。
4. ResultParser：採用多種策略進行強大的HTML解析。

反檢測特性

• 瀏覽器指紋輪換：循環使用逼真的用戶代理。
• 請求頭隨機化：改變請求頭以避免出現模式。
• 定時隨機化：在請求之間添加隨機延遲。
• 會話管理：生成唯一的會話標識符。
• 參數變化：添加隨機搜索參數。

錯誤處理

服務器為以下情況提供了全面的錯誤處理：

• 谷歌的速率限制。
• 網絡超時和連接問題。
• 訪問被拒絕/請求被阻止。
• 無效或空響應。
• 解析失敗時的後備策略。

開發

項目結構

src/
├── server.ts          # 主MCP服務器實現
├── search.ts          # 增強的搜索功能
├── search.test.ts     # 全面的測試套件
└── types.ts           # TypeScript類型定義

代碼質量

項目包含以下內容：

• TypeScript：提供完整的類型安全和智能感知支持。
• ESLint：使用TypeScript規則進行代碼檢查。
• Prettier：確保代碼格式一致。
• Vitest：快速可靠的測試框架。

腳本

• npm run build：將TypeScript編譯為JavaScript。
• npm run start：在生產模式下啟動服務器。
• npm run dev：使用CLI在開發模式下啟動。
• npm run test：運行測試套件。
• npm run test:watch：在監視模式下運行測試。
• npm run lint：檢查代碼質量和類型。
• npm run format：使用Prettier格式化代碼。

測試

測試套件涵蓋以下方面：

• 基本搜索功能。
• 參數驗證和處理。
• 語言和地區過濾。
• 安全搜索和時間範圍過濾。
• 複雜查詢處理。
• 錯誤場景和邊緣情況。
• URL驗證和結果格式化。

所有測試都使用真實的谷歌搜索請求，以確保功能在實際中正常工作。

貢獻

1. 分叉倉庫。
2. 創建功能分支。
3. 進行更改並添加測試。
4. 運行npm run lint和npm run test。
5. 提交拉取請求。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。