Deep_research

Deep Research 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

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_API_KEY は、Serper.dev に登録すると取得できます。

使用方法

MCP サーバーを起動します：

uv run deep_research.py

これにより、deep_research エージェントが MCP サーバーとして起動します。

Docker の使用方法

この MCP サーバーは、Docker コンテナーで実行することもできます：

# 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：エージェントの作成と設定
• scripts/：各種ツールとユーティリティ
  • text_web_browser.py：テキストベースのウェブブラウザー
  • text_inspector_tool.py：ファイル検査ツール
  • visual_qa.py：画像分析ツール
  • mdconvert.py：さまざまなファイル形式を Markdown に変換

ライセンス

このプロジェクトは Apache License 2.0 の下で提供されています。

謝辞

このプロジェクトでは、HuggingFace の smolagents と Microsoft の autogen プロジェクトのコードを使用しています。