Gemini Deepsearch MCP

🚀 Gemini DeepSearch MCP

Gemini DeepSearch MCP 是一款自動化研究代理工具，它藉助 Google Gemini 模型和 Google 搜索，開展深度、多步驟的網絡研究。該工具能夠生成複雜的查詢，整合搜索結果中的信息，識別知識缺口，並給出高質量、附有豐富引用的答案。

✨ 主要特性

• 自動化多步驟研究：藉助 Gemini 模型和 Google 搜索實現。
• FastMCP 集成：支持 HTTP API 和標準輸入輸出（stdio）兩種部署方式。
• 可配置的研究深度：提供低、中、高三種不同的研究深度級別。
• 附有豐富引用的響應：可追蹤信息來源。
• 由 LangGraph 驅動的工作流：具備狀態管理功能。

📦 安裝指南

直接使用 uvx 進行安裝：

uvx install gemini-deepsearch-mcp

💻 使用示例

開發服務器（HTTP + Studio UI）

啟動帶有 Studio UI 的 LangGraph 開發服務器：

make dev

本地 MCP 服務器（stdio）

啟動使用標準輸入輸出傳輸的 MCP 服務器，以便與 MCP 客戶端集成：

make local

測試

運行測試套件：

make test

測試 MCP 標準輸入輸出服務器：

make test_mcp

使用 MCP 檢查器：

make inspect

開啟 Langsmith 跟蹤功能：

GEMINI_API_KEY=AI******* LANGSMITH_API_KEY=ls******* LANGSMITH_TRACING=true make inspect

📚 詳細文檔

API

deep_search 工具接受以下參數：

• query（字符串）：需要研究的問題或主題。
• effort（字符串）：研究的深度級別，可選擇 "low"（低）、"medium"（中）或 "high"（高）。
  • 低：1 個查詢，1 個循環，使用 Flash 模型。
  • 中：3 個查詢，2 個循環，使用 Flash 模型。
  • 高：5 個查詢，3 個循環，使用 Pro 模型。

返回結果：

• answer：附有引用的全面研究響應。
• sources：研究中使用的來源 URL 列表。

Claude 桌面集成

若要在 Claude 桌面版中使用 MCP 服務器，請將以下配置添加到 Claude 桌面版的配置文件中：

macOS

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gemini-deepsearch": {
      "command": "uvx",
      "args": ["gemini-deepsearch-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      },
      "timeout": 180000
    }
  }
}

Windows

編輯 %APPDATA%/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gemini-deepsearch": {
      "command": "uvx",
      "args": ["gemini-deepsearch-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      },
      "timeout": 180000
    }
  }
}

Linux

編輯 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gemini-deepsearch": {
      "command": "uvx",
      "args": ["gemini-deepsearch-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      },
      "timeout": 180000
    }
  }
}

⚠️ 重要提示

• 請將 your-gemini-api-key-here 替換為你實際的 Gemini API 密鑰。
• 更新配置後，請重啟 Claude 桌面版。
• 請設置足夠長的超時時間，以避免出現 MCP error -32001: Request timed out 錯誤。

替代方案：本地開發設置

若你進行開發工作或希望從源代碼運行，可使用以下配置：

{
  "mcpServers": {
    "gemini-deepsearch": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/path/to/gemini-deepsearch-mcp",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

請將 /path/to/gemini-deepsearch-mcp 替換為你項目目錄的實際絕對路徑。

配置完成後，你可以在 Claude 桌面版中使用 deep_search 工具，例如提出以下問題：

• "使用 deep_search 研究量子計算的最新發展"
• "以高深度搜索可再生能源趨勢的相關信息"

🔧 技術細節

深度搜索代理源自 Gemini Fullstack LangGraph Quickstart 倉庫。

📄 許可證

本項目採用 MIT 許可證。