Deep Research MCP Server

by Hajime-Y
Apache 2.0
4
  • Linux
  • Apple

Integrations

  • Uses .env files for managing API keys and configuration variables

  • Integrates with GitHub repositories, including cloning from GitHub URLs as demonstrated in the installation instructions

  • Converts various file formats to Markdown through the mdconvert.py utility

深度研究 MCP 服务器

Deep Research 是一款基于代理的工具,提供网页搜索和高级研究功能。它利用 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
  1. 创建虚拟环境并安装依赖项:
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代理作为 MCP 服务器。

关键组件

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

执照

该项目根据 [许可证名称] 提供。

致谢

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

-
security - not tested
A
license - permissive license
-
quality - not tested

基于代理的工具,提供网络搜索和高级研究功能,包括文档分析、图像描述和 YouTube 成绩单检索。

  1. Features
    1. Requirements
      1. Installation
        1. Environment Variables
          1. Usage
            1. Key Components
              1. License
                1. Acknowledgements
                  ID: c18f8j7nfb