MCP Google Search

🚀 谷歌搜索的模型上下文協議服務器

本項目是一個提供網絡搜索功能的 Model Context Protocol 服務器，藉助 Google Custom Search API 和網頁內容提取功能，為用戶提供便捷的網絡搜索及網頁內容獲取服務。

🚀 快速開始

本服務器可實現網絡搜索和網頁內容提取兩大核心功能，以下為你詳細介紹。

✨ 主要特性

搜索

利用 Google Custom Search API 開展網絡搜索，具備以下優勢：

• 可搜索整個互聯網，也能針對特定網站進行精準搜索。
• 能夠靈活控制搜索結果數量，範圍為 1 - 10 條。
• 獲取的搜索結果為結構化數據，涵蓋標題、鏈接和摘錄等關鍵信息。

網頁閱讀器

可從任意網頁提取所需內容，具體功能如下：

• 自動抓取並解析網頁內容。
• 精準提取頁面標題和正文文本。
• 對網頁內容進行清理，去除腳本和樣式等干擾信息。
• 返回結構化數據，包含標題、文本和 URL 等內容。

📦 安裝指南

獲取 Google API 密鑰和搜索引擎 ID

1. 創建 Google Cloud 項目：
   • 訪問 Google Cloud Console。
   • 可選擇創建新項目或使用現有項目。
   • 務必啟用項目的計費功能。
2. 啟用 Custom Search API：
   • 訪問 API 庫。
   • 在搜索框中輸入 "Custom Search API"。
   • 點擊 "啟用" 按鈕。
3. 獲取 API 密鑰：
   • 訪問 憑證。
   • 點擊 "創建憑證" > "API Key"。
   • 複製生成的 API 密鑰。
   • （可選）為增強安全性，可將密鑰限制為僅用於 Custom Search API。
4. 創建 Custom Search 引擎：
   • 訪問 Programmable Search Engine。
   • 輸入要搜索的網站，若需全網搜索，可使用 www.google.com。
   • 點擊 "創建" 按鈕。
   • 在下一步中，點擊 "自定義"。
   • 在設置中啟用 "搜索整個互聯網" 選項。
   • 複製生成的 Search Engine ID（cx）。

客戶端配置

若要在 Claude Desktop 上使用本服務器，需在服務器配置中添加 Google API 憑證：

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

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@mcp-for-dev/mcp-google-search"],
      "env": {
        "GOOGLE_API_KEY": "你的 API 密鑰",
        "GOOGLE_SEARCH_ENGINE_ID": "你的搜索引擎 ID"
      }
    }
  }
}