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は、Web検索と高度なリサーチ機能を提供するエージェントベースのツールです。HuggingFaceのsmolagentsを活用し、MCPサーバーとして実装されています。

このプロジェクトは、 HuggingFace の open_deep_research の例に基づいています。

特徴

  • ウェブ検索と情報収集
  • PDFとドキュメント分析
  • 画像分析と説明
  • YouTubeトランスクリプトの取得
  • アーカイブサイト検索

要件

  • Python 3.11以上
  • uvパッケージマネージャー
  • 次の API キー:
    • OpenAI APIキー
    • ハギングフェイストークン
    • 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 : テキストベースのウェブブラウザ
    • 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 トランスクリプトの取得などの Web 検索と高度な調査機能を提供するエージェントベースのツールです。

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