Mixelpixx GoogleSearch McpServer

🚀 Google 搜索 MCP 服務器

這是一個具備 Google 搜索功能與網頁內容分析工具的 Model Context Protocol (MCP) 服務器。藉助該服務器，AI 模型能夠以編程方式開展 Google 搜索並對網頁內容進行分析。

🚀 快速開始

此服務器可讓 AI 模型通過編程執行 Google 搜索並分析網頁內容。你可以按照以下步驟進行安裝、配置、構建和運行。

✨ 主要特性

• 集成 Google 自定義搜索，方便進行搜索操作。
• 具備網頁內容分析功能，可深入瞭解網頁信息。
• 支持批量網頁分析，提高處理效率。
• 擁有 MCP 兼容接口，便於與其他系統集成。

📦 安裝指南

先決條件

• Node.js (v16 或更高版本)
• Python (v3.8 或更高版本)
• Google Cloud Platform 賬戶
• 自定義搜索引擎 ID
• Google API Key

安裝步驟

1. 克隆倉庫。
2. 安裝 Node.js 依賴項：

npm install

3. 安裝 Python 依賴項：

pip install flask google-api-python-client flask-cors

📚 詳細文檔

配置

1. 在根目錄中創建一個 api-keys.json 文件，包含你的 Google API 憑據：

{
    "api_key": "your-google-api-key",
    "search_engine_id": "your-custom-search-engine-id"
}

2. 將服務器配置添加到你的 MCP 設置文件中（通常位於 %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "google-search": {
      "command": "npm",
      "args": ["run", "start:all"],
      "cwd": "/path/to/google-search-server"
    }
  }
}

構建

npm run build

運行

同時啟動 TypeScript 和 Python 服務器：

npm run start:all

或者分別運行它們：

• TypeScript 服務器：npm start
• Python 服務器：npm run start:python

💻 使用示例

基礎用法

1. 搜索

執行 Google 搜索並獲取結果。

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num_results": 5 // 可選， 默認值：5
  }
}

2. 分析網頁

從單個網頁提取並分析內容。

{
  "name": "analyze_webpage",
  "arguments": {
    "url": "https://example.com"
  }
}

3. 批量分析網頁

在一次請求中分析多個網頁。

{
  "name": "batch_analyze_webpages",
  "arguments": {
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ]
  }
}

高級用法

可根據實際需求調整搜索參數和分析策略，以滿足不同場景的需求。

🔧 技術細節

服務器由兩個主要部分組成：

1. TypeScript MCP 服務器：處理 MCP 協議通信並提供工具接口。
2. Python Flask 服務器：管理 Google API 交互和網頁內容分析。

📄 許可證

本項目採用 MIT 許可證。

獲取 Google API 憑據

1. 訪問 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用 Custom Search API。
4. 創建 API 憑據（API Key）。
5. 訪問 Custom Search Engine 頁面。
6. 創建新的搜索引擎並獲取你的 Search Engine ID。
7. 將這些憑據添加到 api-keys.json 文件中。

錯誤處理

服務器為以下情況提供詳細的錯誤消息：

• 缺少或無效的 API 憑據。
• 搜索請求失敗。
• 無效的網頁 URL。
• 網絡連接問題。