MCP Google Custom Search Server

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

MCP 谷歌自定義搜索服務器是一個模型上下文協議（MCP）服務器，藉助谷歌的自定義搜索 API 提供網絡搜索功能。它讓語言學習模型（LLMs）能通過標準化接口執行網絡搜索，為語言模型的信息獲取提供了便利。

🚀 快速開始

克隆倉庫

git clone https://github.com/yourusername/mcp-google-custom-search-server.git
cd mcp-google-custom-search-server

安裝依賴項

npm install

創建.env 文件

GOOGLE_API_KEY=你的API密鑰
GOOGLE_SEARCH_ENGINE_ID=你的搜索引擎ID

構建服務器

npm run build

啟動服務器

npm start

✨ 主要特性

• 與谷歌自定義搜索 API 無縫集成
• 符合模型上下文協議（MCP）的服務器實現
• 使用 TypeScript 的安全類型實現
• 環境變量配置
• 使用 Zod 進行輸入驗證
• 可配置搜索結果（最多每條查詢 10 個）
• 格式化的搜索結果包括標題、URL 和描述
• 錯誤處理和驗證
• 與 Claude Desktop 和其他 MCP 客戶端兼容

📦 安裝指南

先決條件

在開始之前，請確保您有：

1. 一個啟用自定義搜索 API 的谷歌雲項目
   • 訪問谷歌雲控制檯
   • 啟用自定義搜索 API
   • 創建 API 憑證
2. 自定義搜索引擎 ID
   • 訪問可編程搜索引擎
   • 創建一個新的搜索引擎
   • 獲取您的搜索引擎 ID
3. 本地開發要求：
   • Node.js（v18 或更高版本）
   • npm（隨 Node.js 提供）

💻 使用示例

搜索工具

要執行搜索，請向/search端點發送 POST 請求：

{
  "queries": ["你的搜索查詢"]
}

響應將包含以下結構：

📚 詳細文檔

配置

環境變量

Claude Desktop 集成

將此配置添加到您的 Claude Desktop 配置文件中（通常位於~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "googleCustomSearchMCP": {
      "url": "http://localhost:3000",
      "id": "your-server-id"
    }
  }
}

項目結構

mcp-google-custom-search-server/
├── src/
│   ├── server.ts          # 主服務器文件
│   └── search.ts         # 搜索處理邏輯
└── package.json        # 項目依賴和腳本

可用腳本

📄 許可證

[許可證鏈接]

🙏 致謝

感謝您使用我們的 MCP 自定義搜索服務器。如果有任何問題或建議，請隨時與我們聯繫。