mcp-research

Webリサーチツールを提供するスタンドアロンのMCP (Model Context Protocol) サーバーです。AIアシスタント向けに、Web検索、ページの取得とMarkdownへの変換、および複合的なマルチソースリサーチの実行という、実戦で鍛えられた3つのツールをMCP stdioプロトコル経由で提供します。

ツール

すべてのツールは読み取り専用です。公開されているWebコンテンツを取得・変換するだけで、何も変更しません。

インストール

pip install mcp-research

または uvx を使用して直接実行します（インストール不要）:

uvx mcp-research

設定

すべての設定は環境変数で行います。設定ファイルは不要です。

Claude Codeでの使用方法

Claude CodeのMCP設定（~/.claude/settings.json またはプロジェクトの .mcp.json）に追加します:

{
  "mcpServers": {
    "research": {
      "command": "uvx",
      "args": ["mcp-research"],
      "env": {
        "BRAVE_API_KEY": "BSA...",
        "OLLAMA_URL": "http://localhost:11434"
      }
    }
  }
}

Claude Desktopでの使用方法

claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "research": {
      "command": "uvx",
      "args": ["mcp-research"],
      "env": {
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

ツールの詳細

web_search

web_search(query, max_results=5, summarize=False, auto_fetch_top=False)

信頼性を最大化するために3段階のカスケードを使用してWebを検索します:

1. Brave Search API — 高速で高品質（BRAVE_API_KEYが必要）

2. DuckDuckGoライブラリ — APIキー不要、レート制限時に再試行

3. DuckDuckGo HTMLスクレイパー — 最後の手段としてのフォールバック

オプション:

• summarize: Ollamaを使用して結果を要約する（Ollamaの実行が必要）

• auto_fetch_top: 上位結果の全コンテンツも取得して返す

fetch_url

fetch_url(url, summarize=False, max_chars=50000)

URLを取得し、クリーンなMarkdownに変換します:

• SSRF保護: ローカルホスト、プライベートIP、非HTTPスキームをブロック

• スマート再試行: 429/5xxエラー時の指数バックオフ、ホップごとのリダイレクト検証

• 24時間キャッシュ: SHA-256キー付き、TTL設定可能

• コンテンツサポート: HTML → Markdown、JSON → コードブロック、バイナリ → 拒否

• スマート切り詰め: テキストの途中ではなく、見出しや段落の境界で分割

research

research(query, depth="standard", context="")

複合リサーチパイプライン:

1. クエリの書き換え — Ollamaが質問を検索キーワードに最適化

2. Web検索 — 関連ページを検索（結果がゼロの場合は再試行して拡張）

3. 並列取得 — 上位Nページを同時に取得

4. 要約 — Ollamaが各ページを要約

5. 合成 — Ollamaが引用付きの最終回答を作成

深度レベル:

すべてのステップはOllamaなしでも正常に機能します。その場合でも、検索結果と生のページコンテンツは取得できます。

開発

git clone https://github.com/MABAAM/Maibaamcrawler.git
cd Maibaamcrawler
pip install -e .
python -m mcp_research

ライセンス

MIT