Deep Research

🚀 深度研究 MCP 服務器

深度研究是一款基於代理的工具，它提供網絡搜索和高級研究功能。此工具藉助了 HuggingFace 的 smolagents 並以 MCP 服務器的形式實現。該項目參考了 HuggingFace 的 open_deep_research 示例。

🚀 快速開始

深度研究 MCP 服務器能幫助你完成網絡搜索、文檔分析等多種研究任務。下面將為你介紹如何安裝和使用該工具。

✨ 主要特性

• 網絡搜索和信息收集
• PDF 和文檔分析
• 圖像分析與描述
• YouTube 字幕獲取
• 存檔網站搜索

📦 安裝指南

安裝要求

• Python 3.11 或更高版本
• uv 包管理器
• 下列 API 密鑰：
  • OpenAI API Key
  • HuggingFace Token
  • SerpAPI Key

安裝步驟

1. 克隆倉庫：

git clone https://github.com/Hajime-Y/deep-research-mcp.git
cd deep-research-mcp

2. 創建虛擬環境並安裝依賴項：

uv venv
source .venv/bin/activate # Linux 或 Mac
# .venv\Scripts\activate # Windows
uv sync

配置環境變量

在項目根目錄下創建一個 .env 文件，並設置以下環境變量：

OPENAI_API_KEY=your_openai_api_key
HF_TOKEN=your_huggingface_token
SERPER_API_KEY=your_serper_api_key

您可以在 Serper.dev 註冊以獲取 SERPER_API_KEY。

💻 使用示例

基礎用法

啟動 MCP 服務器：

uv run deep_research.py

這將啟動 deep_research 代理作為 MCP 服務器。

高級用法

Docker 使用

您也可以在 Docker 容器中運行此 MCP 服務器：

# 構建 Docker 鏡像
docker build -t deep-research-mcp .

# 使用所需的 API 密鑰運行
docker run -p 8080:8080 \
  -e OPENAI_API_KEY=your_openai_api_key \
  -e HF_TOKEN=your_huggingface_token \
  -e SERPER_API_KEY=your_serper_api_key \
  deep-research-mcp

在 MCP 客戶端中註冊

要在不同的客戶端中將此 Docker 容器註冊為 MCP 服務器：

Claude Desktop

在您的 Claude Desktop 配置文件中添加以下內容（通常位於 ~/.config/Claude/claude_desktop_config.json Linux、~/Library/Application Support/Claude/claude_desktop_config.json macOS 或 %APPDATA%\Claude\claude_desktop_config.json Windows）：

{
  "mcpServers": {
    "deep-research-mcp": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "-e", "OPENAI_API_KEY=your_openai_api_key",
        "-e", "HF_TOKEN=your_huggingface_token",
        "-e", "SERPER_API_KEY=your_serper_api_key",
        "deep-research-mcp"
      ]
    }
  }
}

其他客戶端

根據具體客戶端的文檔進行相應配置，確保所有環境變量正確設置。

🔧 技術細節

關鍵組件

• Deep Research：核心代理模塊，負責處理搜索和分析任務。
• MCP 服務器：用於協調和管理多個代理的通信與任務分配。
• Docker 配置：提供容器化部署支持，簡化安裝和維護流程。