mcp-web-research

@opafex/mcp-web-research

ウェブ調査用の MCP サーバーです。ウェブを検索し、ページを整形されたテキストとして取得したり、ページから名前を指定したセクションを抽出したり、複数のページを並べて比較したり、「検索して上位の結果を読む」という2段階の処理を実行したりできます。

LLM は使用しません。research_topic と compare_pages は抽出したテキストを整理するものであり、テキストを生成するものではありません。リダイレクトのすべての段階を含め、ページを取得するたびにSSRFチェックを行います。

検索には Brave Search API を使用します（無料プランも利用できます）。APIキーがなくても4つのページツールは動作しますが、2つの検索ツールは設定する変数名を示すエラーを返します。

インストール

npx -y @opafex/mcp-web-research

Node.js 20+ が必要です。ほかにインストールが必要な依存関係はありません。

クイックスタート

Claude Code

claude mcp add web-research -e BRAVE_SEARCH_API_KEY=your-key -- npx -y @opafex/mcp-web-research

または、プロジェクトのルートにある .mcp.json に追加します。

{
  "mcpServers": {
    "web-research": {
      "command": "npx",
      "args": ["-y", "@opafex/mcp-web-research"],
      "env": {
        "BRAVE_SEARCH_API_KEY": "your-key"
      }
    }
  }
}

Claude Desktop

同じブロックを claude_desktop_config.json に追加します（設定 → 開発者 → 設定を編集）。

{
  "mcpServers": {
    "web-research": {
      "command": "npx",
      "args": ["-y", "@opafex/mcp-web-research"],
      "env": {
        "BRAVE_SEARCH_API_KEY": "your-key"
      }
    }
  }
}

ページツールのみを使用する場合は、BRAVE_SEARCH_API_KEY を省略します。

ツール

web_search

SSRFチェック（下記）に失敗した結果URLは、返される前に除外されます。

[
  {
    "title": "Model Context Protocol",
    "url": "https://modelcontextprotocol.io/",
    "snippet": "An open protocol that enables seamless integration between LLM applications and external data sources and tools."
  }
]

fetch_webpage

スクリプト、スタイル、<nav>、<footer> は削除されます。リダイレクトを経由してページに到達した場合は、finalUrl が含まれます。

{
  "title": "Example Domain",
  "text": "Example Domain\nThis domain is for use in illustrative examples in documents.",
  "url": "http://example.com/",
  "fetchedAt": "2026-10-24T12:00:00.000Z"
}

research_topic

重要なポイントとは、トピックに含まれる語句に言及している文のことで、ソースごとに最大5件までです。取得できないソースについては、検索スニペットを代わりに使用します。

extract_structured_data

各フィールドについて、そのフィールドに言及している最初の行と、その後の10行を、最大1,000文字まで返します。該当するセクションがない場合は No "<field>" section found on page. を返します。これは見出しを照合するものであり、スキーマ抽出ではありません。

compare_pages

取得に失敗したページは、理由とともに "(fetch failed)" と表示されます。それ以外のページは引き続き比較されます。

リソース

検索プロバイダー

DuckDuckGo オプションについて。 html.duckduckgo.com の検索結果ページを解析します。これは API ではありません。DuckDuckGo がマークアップを変更すると動作しなくなり、レート制限やブロックの対象となる可能性があります。また、DuckDuckGo の利用規約では自動クエリが許可されていません。このサーバーはブラウザーを装うことなく、正直なユーザーエージェントを送信するため、ブロックされる可能性が高くなります。個人的な実験用に用意されています。有効にする場合は、DuckDuckGo の利用規約を遵守する責任を負います。依存する用途には Brave を使用してください。

環境変数

セキュリティ

ページツールは、モデルが選んだ URL をサーバーの実行マシンから取得します。保護がなければ、そのマシンのプライベートネットワークやクラウドのメタデータサービスに、ツール呼び出し 1 回でアクセスできてしまいます（サーバーサイドリクエストフォージェリ）。取得前にすべてのリクエストをチェックし、次の場合は拒否します。

• スキームが http または https ではない場合。
• ホストが localhost、*.localhost、またはクラウドのメタデータ名（metadata.google.internal）の場合。
• ホストが、プライベート範囲にあるリテラル IP（IPv4 または角括弧で囲まれた IPv6）の場合。特殊な IPv4 表記（http://2130706433/、http://0x7f.1/）はチェック前に正規化されます。
• ホスト名が解決するアドレス（IPv4（A）または IPv6（AAAA））のいずれかがプライベート範囲にある場合。パブリックな A レコードが 1 つあっても、プライベートな AAAA レコードがあれば許可されません。
• ホスト名を解決できない場合。**チェックはフェイルクローズで動作します。**チェックできなかったアドレスは取得されません。

ブロック対象の範囲：

リダイレクトは手動でたどり、各ホップを再チェックします（最大 5 ホップ）。パブリックページが http://169.254.169.254/ にリダイレクトする場合、2 回目のリクエストを行う前に拒否されます。検索結果の URL もチェックされ、条件を満たさないものは除外されます。

**既知の制限 — DNS リバインディング。**チェック時にホスト名を解決し、その後 fetch が接続のために再度解決します。TTL が非常に短い悪意ある DNS サーバーは、2 回の名前解決に異なる応答を返す可能性があります。この隙間をなくすには、チェック済みアドレスに接続を固定する必要がありますが、Node の組み込み fetch では追加の依存関係なしにそれを指定できません。このサーバーを機密性の高い内部サービスがある場所で実行する場合は、ネットワークレベルでもアクセス可能な範囲を制限してください（コンテナのネットワークポリシー、送信ファイアウォール）。

制限事項

• **テキストのみ。**ページの MIME タイプは text/*、application/xhtml+xml、または application/json である必要があります。PDF、画像、その他のバイナリ形式は拒否されます。
• **JavaScript は実行されません。**ページは配信された状態のまま取得されます。クライアント側でレンダリングされるコンテンツは含まれません。
• **正規表現ベースの HTML 解析。**高速で依存関係も不要ですが、完全な HTML パーサーではないため、特殊なマークアップがテキストに混入することがあります。
• ヒューリスティックによる抽出。research_topic の要点と extract_structured_data のセクションは、理解に基づくものではなくキーワード照合です。
• メモリ内キャッシュはプロセスごとに保持され、再起動時に失われます。
• **UTF-8 を前提としています。**それ以外のエンコーディングのページは、置換文字を使ってデコードされる場合があります。
• **クローラーではありません。**robots.txt は処理せず、指定された URL を取得します。

開発

npm run build    # Compile TypeScript
npm run dev      # Run with tsx (no build needed)
npm test         # Run tests (no network — fetch and DNS are faked)
npm start        # Run compiled server

貢献

バグを見つけた場合や機能のリクエストがある場合は、issue を作成してください。

プルリクエストも歓迎します。開発環境のセットアップについては、メインリポジトリをご覧ください。

ライセンス

MIT — LICENSE をご覧ください。