A
securityF
licenseA
qualityA powerful research assistant that conducts intelligent, iterative research through web searches, analysis, and comprehensive report generation on any topic.
Last updated -
4
23
ディープリサーチMCPサーバー
Deep Researchは、Web検索と高度なリサーチ機能を提供するエージェントベースのツールです。HuggingFaceのsmolagentsを活用し、MCPサーバーとして実装されています。
このプロジェクトは、 HuggingFace の open_deep_research の例に基づいています。
特徴
ウェブ検索と情報収集
PDFとドキュメント分析
画像分析と説明
YouTubeトランスクリプトの取得
アーカイブサイト検索
要件
Python 3.11以上
uvパッケージマネージャー次の API キー:
OpenAI APIキー
ハギングフェイストークン
SerpAPIキー
インストール
リポジトリをクローンします。
git clone https://github.com/Hajime-Y/deep-research-mcp.git
cd deep-research-mcp
仮想環境を作成し、依存関係をインストールします。
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 サーバーとして起動します。
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 構成ファイル (通常、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"
]
}
}
}
カーソルIDE
カーソル 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プロジェクトのコードを使用します。
This server cannot be installed
Related Resources
Related MCP Servers
- -security-license-qualityEnables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.Last updated -41
- -securityFlicense-qualityAn AI-focused search engine that enables AI applications to access high-quality knowledge from billions of webpages and ecosystem content sources across various domains including weather, news, encyclopedia, medical information, train tickets, and images.Last updated -30
- AsecurityAlicenseAqualityA sophisticated research assistant that orchestrates a 5-step workflow of connected AI agents to provide deep research capabilities including question enhancement, web search, summarization, citation formatting, and result combination.Last updated -11MIT License