Deep Research

🚀 深度研究 MCP サーバー

深度研究は、代理に基づくツールで、ウェブ検索と高度な調査機能を提供します。このツールは HuggingFace の smolagents を利用し、MCP サーバーとして実装されています。

このプロジェクトは HuggingFace の open_deep_research サンプル に基づいています。

✨ 主な機能

• ウェブ検索と情報収集
• 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_API_KEY は Serper.dev で登録して取得できます。

💻 使用例

基本的な使用法

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 の設定ファイル（通常は 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"
      ]
    }
  }
}

その他のクライアント

各クライアントのドキュメントに従って設定し、すべての環境変数が正しく設定されていることを確認してください。

🔧 技術詳細

• Deep Research：検索と分析タスクを処理する核心的なエージェントモジュール。
• MCP サーバー：複数のエージェントの通信とタスク割り当てを調整および管理します。
• Docker 設定：コンテナ化されたデプロイをサポートし、インストールとメンテナンスのプロセスを簡素化します。