Deep_research

Deep Research MCP 服务

Deep Research 是一款基于 Agent 的工具，提供网页搜索和高级研究功能。它采用 HuggingFace 的 smolagents，并以 MCP 服务的形式实现。

本项目基于 HuggingFace 的 open_deep_research 示例。

功能

• 网页搜索和信息收集
• PDF 和文档分析
• 图像分析和描述
• 获取 YouTube 字幕文本
• 搜索归档网站

要求

• Python 3.11 或更高版本
• uv 包管理器
• 以下 API 密钥：
  • OpenAI API 密钥
  • HuggingFace 令牌
  • SerpAPI 密钥

安装

1. 克隆仓库：

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

2. 创建虚拟环境并安装依赖项：

uv venv
source .venv/bin/activate # For Linux or Mac
# .venv\Scripts\activate # For 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 Agent 作为 MCP 服务。

Docker 用法

你也可以在 Docker 容器中运行此 MCP 服务：

# Build the Docker image
docker build -t deep-research-mcp .

# Run with required API keys
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 配置文件中（通常位于 Linux 的 ~/.config/Claude/claude_desktop_config.json、macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "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"
      ]
    }
  }
}

Cursor IDE

对于 Cursor IDE，请添加以下配置：

{
  "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"
      ]
    }
  }
}

与远程 MCP 服务搭配使用

如果你在远程计算机上运行 MCP 服务，或将其作为服务公开，则可以使用基于 URL 的配置：

{
  "mcpServers": {
    "deep-research-mcp": {
      "url": "http://your-server-address:8080/mcp",
      "type": "sse"
    }
  }
}

关键组件

• deep_research.py：MCP 服务的入口点
• create_agent.py：Agent 的创建和配置
• scripts/：各种工具和实用程序
  • text_web_browser.py：基于文本的网页浏览器
  • text_inspector_tool.py：文件检查工具
  • visual_qa.py：图像分析工具
  • mdconvert.py：将各种文件格式转换为 Markdown

许可证

本项目基于 Apache License 2.0 提供。

致谢

本项目使用了 HuggingFace 的 smolagents 项目和 Microsoft 的 autogen 项目中的代码。