Google Search MCP Server

🚀 谷歌搜索 MCP 服務器

本項目是一個集成了 Google 自定義搜索 JSON API 的 MCP 服務器實現，能夠為用戶提供強大的網絡搜索功能，滿足多樣化的搜索需求。

✨ 主要特性

• 網頁搜索：支持使用全面的查詢選項在 Google 上進行搜索。
• 高級過濾：可通過日期、語言、國家和安全搜索級別等條件，精準控制搜索結果。
• 限流：內置限流功能，有效防止超出 API 配額。
• 結構化結果：返回格式化的搜索結果，包含標題、URL 和摘錄，方便用戶查看。

📦 安裝指南

獲取 API 密鑰

1. 在 Google Cloud Console 創建一個 Google Cloud 項目。
2. 在 API Dashboard 激活 Custom Search JSON API。
3. 通過 Credentials 部分或按照 Custom Search API 指南 生成一個 API 密鑰。
4. 通過設置自定義搜索引擎在 Google 的可編程搜索 獲取搜索引擎 ID。

環境變量

在運行服務器之前，需設置以下環境變量：

export GOOGLE_API_KEY="your-api-key"
export GOOGLE_SEARCH_ENGINE_ID="your-search-engine-id"

從本地倉庫運行

直接從源代碼運行服務器，可按以下步驟操作：

1. 克隆倉庫

git clone https://github.com/ayush-rudani/google-search-mcp-server.git
cd google-search-mcp-server

2. 安裝依賴項

pnpm install
# 或者
npm install

3. 構建項目

pnpm run build
# 或者
npm run build

4. 配置 Claude Desktop 更新 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "google-search": {
      "command": "/path/to/node", // <--- 在終端運行 `echo "$(which node)"` 以獲取路徑
      "args": ["/full/path/to/google-search-mcp/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
      }
    }
  }
}

請將 /path/to/node 替換為你係統中 Node.js 可執行文件的完整路徑。 5. 測試服務器

export GOOGLE_API_KEY=你的_api_key_here
export GOOGLE_SEARCH_ENGINE_ID=你的_engine_id_here
node dist/index.js

📚 詳細文檔

工具

google_search

該工具可使用高級過濾選項執行 Google 搜索，其輸入參數如下：

🔧 技術細節

該服務器默認啟用每分鐘 10 次請求的速率限制，以防止超出 Google 的 API 配額。你可以在代碼中調整此設置。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。