MCP Google Custom Search Server

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

MCP 谷歌自定義搜索服務器是一個符合模型上下文協議（MCP）的服務器，藉助谷歌的自定義搜索 API 提供網絡搜索功能。它為語言學習模型（LLMs）搭建了統一接口，讓其能夠便捷地執行網絡搜索。

🚀 快速開始

1. 克隆倉庫：

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

2. 安裝依賴：

   npm install
   

3. 創建.env 文件：

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

4. 構建服務器：

   npm run build
   

5. 啟動服務器：

   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 提供）

💻 使用示例

基礎用法

以下是使用該服務器進行搜索的示例代碼：

// 假設這裡有調用搜索接口的代碼示例
// 這裡只是佔位，實際代碼需要根據具體實現補充
// 例如：
// const response = await search('example query');
// console.log(response);

📚 詳細文檔

項目文檔位於GitHub 倉庫中，詳細介紹瞭如何使用和擴展該庫。

🔧 技術細節

配置

環境變量

Claude Desktop 集成

在 Claude Desktop 配置文件中添加以下內容（通常位於~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-google-custom-search-server/build/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "你的API密鑰",
        "GOOGLE_SEARCH_ENGINE_ID": "你的搜索引擎ID"
      }
    }
  }
}

API 參考

可用工具

search

使用谷歌自定義搜索 API 執行網絡搜索。 參數：

• query（字符串）：要搜索的關鍵詞。
• num（整數，可選）：返回的結果數量，默認為 10。 返回格式：

{
  "items": [
    {
      "title": "結果標題",
      "link": "結果鏈接",
      "snippet": "結果摘要"
    },
    ...
  ]
}

項目結構

• src/: 包含核心業務邏輯。
• build/: 構建後的輸出文件。

可用腳本

• npm run build：構建服務器。
• npm start：啟動服務器。
• npm test：運行測試用例。

📄 許可證

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

🎁 致謝

感謝開源社區的支持與貢獻。本項目基於以下庫實現：

• express
• node-fetch

希望這個項目能為你的開發工作提供便利！如果有任何問題或建議，請隨時提交 Issues。