Google MCP Server

🚀 谷歌MCP服務器

該項目實現了一個用於Google API的模型上下文協議（MCP）服務器，支持與AI助手和其他MCP兼容客戶端集成，為用戶提供便捷的搜索服務。

🚀 快速開始

本服務器的使用需要滿足一定的先決條件，並且按照特定步驟進行安裝和配置。

先決條件

• Node.js 18+ 版本
• npm 包管理器

安裝步驟

1. 克隆倉庫

git clone https://github.com/your-username/mcp-google-search.git
cd google-mcp-server

2. 安裝依賴項

npm install

3. 配置Google自定義搜索API憑證

在項目根目錄創建一個.env文件，內容如下：

GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_CX_ID=your_custom_search_engine_id_here

• GOOGLE_API_KEY：您的Google自定義搜索API密鑰。
• GOOGLE_CX_ID：您的自定義搜索引擎ID。

您可以在Google自定義搜索JSON API文檔中獲取這些信息。

💻 使用示例

基礎用法

1. 運行測試搜索

npx ts-node src/test.ts

這將執行一次樣例搜索，並在控制檯輸出結果。

高級用法

2. 集成到MCP兼容客戶端

要在MCP配置文件（例如claude_desktop_config.json）中使用此服務器，請添加如下條目：

{
  "mcpServers": {
    "google-api": {
      "command": "npx",
      "args": ["ts-node", "src/index.ts"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key_here",
        "GOOGLE_CX_ID": "your_custom_search_engine_id_here"
      }
    }
  }
}

請將API密鑰和CX ID替換為您的實際憑證。

✨ 主要特性

該服務器提供了以下工具：

1. googleSearchContent：使用Google自定義搜索API執行網絡搜索，並返回結構化結果（標題、鏈接和摘錄）。
2. googleSearchImages：使用Google自定義搜索API執行圖片搜索，並返回第一個結果的Markdown圖片鏈接。

查看src/tools.ts中的源代碼以獲取詳細使用信息。

📚 詳細文檔

開發

對項目進行修改時：

1. 按需修改src目錄下的代碼。
2. 如果添加或移除依賴項，請更新package.json文件。
3. 重新啟動您的MCP客戶端或測試腳本以應用更改。

故障排除

• 確保Google API密鑰和CX ID正確設置在.env文件或環境中。
• 檢查所有依賴項是否已安裝（npm install）。
• 驗證Node.js版本為18或更高。
• 修改代碼後請重新啟動服務器或測試腳本。

📄 許可證

該項目採用MIT許可證。