mcpField
W
web-retrieval-mcp

web-retrieval-mcp

ローカル
github.com検索68 週間前に更新

web-retrieval-mcp について

web-retrieval-mcpは、AIエージェント向けの出典を追跡できるウェブ調査用MCPサーバーです。検索、段階的なページ取得、論文や開発者向け資料の検索をまとめ、取得元と経路を示します。

主な機能

  1. 01ExaまたはTavilyでウェブ検索
  2. 02段階的なページ取得とフォールバック
  3. 03要約または根拠に基づく回答
  4. 04AI/ML論文の検索
  5. 05開発ドキュメントやリポジトリ資料の検索
  6. 06出典と取得経路の表示

活用シーン

  1. 01出典リンクを保ちながらテーマを調査
  2. 02ブラウザー描画が必要なページを取得
  3. 03AI/ML論文や関連研究を探す
  4. 04ドキュメント、README、Issue、マージ済みPRを検索

MCP 対応

ウェブ検索、ページ取得、AI/ML論文調査、開発者向け資料検索を行う6つの読み取り専用ツールをMCPクライアントに公開します。stdioとStreamable HTTPに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"velvetsp-web-retrieval": {
"command": "uvx",
"args": [
"web-retrieval-mcp"
],
"env": {
"EXA_API_KEY": "<EXA_API_KEY>",
"FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
}
}
}
}
起動コマンドuvx web-retrieval-mcp
設定が必要な環境変数
EXA_API_KEYシークレットExa API key (free tier at https://exa.ai)
FIRECRAWL_API_KEYシークレットFirecrawl API key (free tier at https://firecrawl.dev)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiweb-retrieval-mcp0.1.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

web-retrieval-mcp — AI エージェント向けの信頼性の高い MCP ウェブ検索とページ取得

ソースに基づくウェブ調査のためのオープンソースの Model Context Protocol (MCP) サーバーです。Codex CLI と Codex IDE 拡張機能、Claude Code、Claude Desktop、Cursor、ChatGPT desktop、またはその他の互換性のある MCP クライアントを、Exa または Tavily による検索、Exa → Camoufox → Tavily → Firecrawl の堅牢なページ取得、AI/ML 論文の検索、開発者向けソース検索に対応する、読み取り専用の 6 つのツールに接続できます。出典の明示、任意のローカルキャッシュ、SSRF 対策を備えています。

PyPI CI Python 3.10+ License: MIT Model Context Protocol

選ばれる理由 · クイックスタート · ツール · ルーティング · 設定 · セキュリティ · よくある質問

web-retrieval-mcp が選ばれる理由

エージェントが各検索結果の出典を確認し、適切な取得方法を選び、プロバイダーやページへのアクセス方法に障害が発生した場合にも復旧できると、ウェブ調査の信頼性が高まります。web-retrieval-mcp は、こうした制御をツールの仕様に組み込んでいます。

  • 出典を個別に保ちます。 デフォルトの検索では、タイトル、URL、ハイライト、テキストを含む結果ごとのブロックを返し、その後に Sources の一覧を付けます。Exa の詳細モードでは、出典ごとに分けた結果ブロックの前に、明確にラベル付けされた合成回答を返します。Exa が根拠情報を提供する場合は、それも含まれます。
  • 複数の取得経路を利用します。 検索では Exa または Tavily を利用でき、Firecrawl にフォールバックできます。ページ全体の取得では、インデックス済みコンテンツから始め、ローカルの Camoufox ブラウザー、任意の Tavily Extract、Firecrawl へと段階的に切り替えられます。
  • 回答を実際に提供した経路を把握できます。 取得結果には、経路を隠すことなく、処理した階層、キャッシュの状態、セマンティックモード、切り捨ての有無が示されます。
  • 必要な形式を指定できます。 読みやすいページ本文、簡潔な要約、または質問への根拠に基づく回答を取得できます。鮮度、レンダリング、ドメイン、日付、結果数、結果ごとのテキスト量も指定できます。
  • 専門分野のコーパスを検索できます。 AI/ML 論文を検索し、クエリに関連する全文の箇所を確認し、関連論文を追加で検索できます。また、開発者向けドキュメント、README、Issue、マージ済みプルリクエストも検索できます。
  • デプロイ境界を自分で管理できます。 stdio 経由でローカル実行するか、ループバック HTTP サービスとしてホストできます。プロバイダーとシークレットの保存先を自分で選択でき、完了したページ取得結果をプライベートな Valkey サイドカーに任意でキャッシュできます。
  • 問題を明示的に通知します。 サポートされていないプロバイダーの選択、任意パッケージの不足、認証情報の利用不可は、ツールの結果でエラーとして通知されます。Tavily へのマッピング、Firecrawl フォールバックでのフィルターの不足、Exa カテゴリーの移行については呼び出し元に通知されます。その他の Exa フィルターの除外は、サーバーの診断情報に記録されます。
組み込みのエージェント向けウェブツールとの比較

組み込み機能はエージェントごとに異なり、時間とともに改善されることもあります。そのため、有用な比較の観点は「すべてのデフォルト機能が劣っているか」ではなく、現在のクライアントでは公開されていない制御機能を備えた、移植可能で検査可能な検索レイヤーが必要かどうかです。

ニーズ一般的な組み込み検索/取得機能web-retrieval-mcp
検索結果の出力クライアントが定める結果または統合形式デフォルトの検索では、ソースごとに分けられたブロックと Sources を返します。Exa の詳細モードでは、ラベル付きの統合結果も追加されます
バックエンドの選択通常、プロバイダーとルーティングはクライアントが管理しますExa または Tavily による検索と、明示された Firecrawl フォールバック
アクセスが難しいページクライアント固有のアクセス経路が 1 つインデックス済みコンテンツ、ガード付きのローカルブラウザー描画、Tavily Extract、Firecrawl の各階層
検索の意図通常は検索またはページテキスト本文全体、簡潔な要約、またはクエリに基づくページの回答
調査対象の発見一般的なウェブインデックスウェブ検索に加え、論文専用および開発者向けソース専用のツール
鮮度とフィルタークライアントが公開する機能に準拠日付範囲、時間単位の新しさ、ドメイン、カテゴリ、結果数の上限、鮮度の強制指定
監査可能性クライアント固有取得階層/キャッシュ/切り捨てに関する開示、Tavily および Firecrawl の検索フォールバックラベル、対応箇所での明示的なフィルターメッセージ
運用クライアントが定義。ホスト型または不透明な場合が多いローカル stdio またはセルフホスト可能なループバック HTTP、オプションのプライベート UDS キャッシュ
セキュリティポリシークライアント固有初期 URL の検証に加え、ガード付きのブラウザーリクエストとリダイレクト

デフォルトでは、独立した補完用の検索経路として使用してください。Claude Code の組み込み WebSearch および WebFetch を置き換えたい場合は、パッケージに、プレビュー可能なオプションのフックインストーラーも含まれています。

クイックスタート

Python 3.10 以降が必要です。

1. インストール

隔離環境で全機能を利用するには、次のようにします。

pipx install --include-deps 'web-retrieval-mcp[all]'
camoufox fetch

--include-deps を指定すると、隔離された pipx 環境から Camoufox 自身のコマンドを実行できるようになります。2 つ目のコマンドで、管理対象のブラウザーをダウンロードします。ローカル描画が不要な場合は、基本パッケージまたは選択した非描画用エクストラをインストールし、ブラウザーのダウンロードを省略してください。

Exa と Firecrawl に絞った軽量なインストールの場合:

pipx install web-retrieval-mcp

uv がインストールされていれば、永続的にインストールせず、一時的な隔離環境で基本パッケージを実行できます。

uvx web-retrieval-mcp

既存の仮想環境にインストールすることもできます。

python -m pip install 'web-retrieval-mcp[all]'
python -m camoufox fetch

render エクストラをインストールし、render="auto" または render="always" の呼び出しに Camoufox を使用する場合は、ブラウザーのダウンロードが必要です。

オプションのエクストラは組み合わせて使用できます。

エクストラ追加される機能
tavilyTavily Search と Tavily Extract
renderローカル Camoufox/Playwright 描画
cache完了済み結果のキャッシュ用 Valkey クライアント
keyringクロスプラットフォームのネイティブなシークレットストアへのアクセス
all上記のすべてのオプションのランタイム機能
2. プロバイダーの認証情報を追加する

幅広いルーティングに対応するには、Exa と Firecrawl を設定してください。プロバイダーを選択できる検索や、別の全文取得層が必要な場合は、Tavily も追加してください。

export EXA_API_KEY='<your-exa-api-key>'
export FIRECRAWL_API_KEY='<your-firecrawl-api-key>'
export TAVILY_API_KEY='<your-tavily-api-key>'   # optional

サーバーを起動する際に、3 つすべてのキーを用意する必要はありません。ツールは認証情報を遅延解決し、選択したルートで不足している情報を報告します。キーのファイルや OS のシークレットストアを使う方法については、認証情報の保存をご覧ください。

2026-09-01 に確認したところ、3 つのプロバイダーはいずれも、カード不要の初回利用枠を提供していました。プランや単価は変更される可能性があるため、利用量を見積もる前に最新の料金を確認してください。

プロバイダー2026-09-01 に確認した初回利用枠用途
Exa登録時のクレジット $20 に加え、毎月の API クレジット $10デフォルトのウェブ検索と、インデックス化されたコンテンツの最初の取得層
Firecrawl月間 1,000 クレジット検索/取得のフォールバック、リサーチ/開発者向けインデックス
Tavily月間 1,000 API クレジットオプションの検索プロバイダーと全文抽出層
Camoufoxローカルのオープンソースブラウザーお使いのマシンでの、JavaScript で描画されるページの取得
3. MCP クライアントを接続する

Codex CLI と Codex IDE 拡張機能は、MCP の設定を共有します。CLI でサーバーを追加し、登録されていることを確認してください。

codex mcp add web-retrieval -- web-retrieval-mcp
codex mcp list

事前にインストールせず、uvx を使う場合:

codex mcp add web-retrieval -- uvx web-retrieval-mcp

最新の CLI、IDE、設定ファイルの詳細については、OpenAI のCodex MCP ドキュメントをご覧ください。

Claude Code:

claude mcp add web-retrieval -- web-retrieval-mcp

事前にインストールせず、uvx を使う場合:

claude mcp add web-retrieval -- uvx web-retrieval-mcp

Claude Desktop、Cursor、その他 mcpServers オブジェクトを受け付けるクライアントでは、次の設定を使用できます。

{
  "mcpServers": {
    "web-retrieval": {
      "command": "web-retrieval-mcp"
    }
  }
}

この設定は、実行ファイルがクライアントの PATH にあることを前提としています。uvx で起動する場合は、"command": "uvx" と "args": ["web-retrieval-mcp"] を使用してください。 デスクトップクライアントがシェル環境を引き継がない場合は、以下で説明する秘密鍵ファイルを使うか、クライアントの保護された環境設定にキーの値を直接記述してください。クライアントのドキュメントに記載がない限り、${VARIABLE} による展開に依存しないでください。

ChatGPT デスクトップ版や、設定方法が異なるクライアントは、現在のバージョンがサポートする MCP トランスポートを使って接続できます。このサーバーはデフォルトで stdio を使用し、Streamable HTTP も公開できます。設定形式とサポートされるトランスポートについては、クライアントのドキュメントを参照してください。

4. エージェントに具体的なタスクを指示する

MCP サーバーに接続すると、自然な表現でプロンプトを入力できます。

Search the web for the latest primary documentation about Python package metadata.
Keep each source separate and preserve its URL.

Fetch https://example.com/report, force a fresh retrieval, and answer only:
What methodology did the authors use?

Find AI/ML papers about retrieval reranking, inspect the strongest paper for its
reported benchmark result, then find newer work that cites it.

Search merged pull requests and documentation for the origin of this exact error:
"transport closed".

6 つの読み取り専用ツール

すべてのツールには、MCP の読み取り専用アノテーションが付いています。MCP クライアントは、接続時に生成された入力スキーマと説明の全体を受け取ります。

ツール簡潔なシグネチャ最適な用途
web_searchweb_search(query, num_results=8, mode="auto", …, provider=None)Exa または Tavily による一般的なウェブ検索。ソース別の検索結果と Firecrawl によるフォールバックに対応
web_fetchweb_fetch(url, render="auto", max_chars=None, max_age_hours=None, mode="full", question=None, tavily=None)段階的な取得カスケードによる、読みやすいページ本文、簡潔な要約、または根拠に基づく回答
research_papersresearch_papers(query, k=8)Firecrawl の Research Index による、AI/ML 論文のランキング付き検索
research_paperresearch_paper(paper_id, query=None)論文のメタデータと、主張の検証に役立つ、クエリに関連する任意の全文箇所
research_similarresearch_similar(paper_id, intent, k=8, mode="similar", …)自然言語の意図に基づく、関連論文、引用論文、または参考文献
research_githubresearch_github(query, k=8, passages=2, types=None, repos=None)開発者向けドキュメント、リポジトリの README、Issue、マージ済みプルリクエスト

web_search は、関連度または日付を基準にしたフィルター、ドメインの包含/除外、公開期間、検索結果ごとに生成される要約、Exa の高速/詳細検索モードに対応しています。 Tavily では、API が対応する範囲で同等の制御を利用できます。近似的な動作や適用されない制御は、出力で明示されます。

論文のリサーチインデックスは arXiv を中心としており、AI/ML に最適です。この対象範囲外の学術研究には、web_search(category="publication") を使用してください。

取得の仕組み

検索ルーティング

Exa がデフォルトの検索プロバイダーです。1 回の呼び出しで Tavily を選択するには provider="tavily" を指定します。グローバルに選択するには、次のようにします。

export WEB_SEARCH_PROVIDER=tavily

指定できるのは exa と tavily のみです。選択したプロバイダーに障害が発生した場合、サーバーは Firecrawl を試し、結果には障害が発生したプライマリプロバイダーと、代わりに応答したプロバイダーの両方が記載されます。

取得ルーティング

自動モードで通常の全文取得をリクエストした場合:

Exa indexed contents
        ↓ unusable or unavailable
guarded local Camoufox browser
        ↓ unusable or unavailable
optional Tavily Extract
        ↓ unusable or unavailable
Firecrawl
  • render="auto" は、この適応型カスケードを使用します。
  • render="never" は、ローカルブラウザーの使用を禁止します。
  • render="always" は、ローカルブラウザーから開始し、Exa をスキップします。任意の Tavily と Firecrawl は、引き続きバックアップとして利用されます。
  • mode="concise" は、簡潔な生成要約をリクエストします。
  • question="…" は、ページ全体ではなく、根拠に基づく回答をリクエストします。
  • max_age_hours=0 は、プロバイダーに最新情報の取得を強制します。-1 は、Exa の常時キャッシュ利用動作をリクエストします。正の値は、鮮度の期間を設定します。
  • Exa の本文サイズ上限を超える全文取得が明示的にリクエストされた場合、短い本文を黙って返すのではなく、リクエストされたサイズに対応できる段階から開始します。

Tavily Extract は、呼び出しごとに tavily=true を指定するか、グローバルに有効にします。

export WEB_FETCH_TAVILY_TIER=1

Tavily Extract は全文取得の段階です。簡潔な回答、質問応答、または明示的な鮮度の条件に対応できない場合、サーバーは Tavily Extract をスキップします。

認証情報の保存

サーバーは、各 API キーを必要になった時点で、次の順序で解決します。

  1. プロセス環境内の EXA_API_KEY、FIRECRAWL_API_KEY、または TAVILY_API_KEY。
  2. dotenv 形式の非公開キーファイル。
  3. 任意の Python keyring パッケージ。
  4. macOS Keychain または Linux Secret Service のコマンドラインクライアント。

デフォルトのキーファイルは次のとおりです。

  • Linux/macOS:${XDG_CONFIG_HOME:-~/.config}/web-retrieval-mcp/keys.env
  • Windows:%APPDATA%\web-retrieval-mcp\keys.env

ファイルを WEB_RETRIEVAL_MCP_ENV_FILE で、またはそのディレクトリを WEB_RETRIEVAL_MCP_CONFIG_DIR で上書きできます。POSIX システムでは、グループや他のユーザーがファイルを読み取れないようにする必要があります。

install -d -m 700 ~/.config/web-retrieval-mcp
printf '%s\n' \
  'EXA_API_KEY=<your-exa-api-key>' \
  'FIRECRAWL_API_KEY=<your-firecrawl-api-key>' \
  'TAVILY_API_KEY=<your-tavily-api-key>' \
  > ~/.config/web-retrieval-mcp/keys.env
chmod 600 ~/.config/web-retrieval-mcp/keys.env

keyring を使用する場合は、サービス web-retrieval-mcp の下に各シークレットを保存し、環境変数名をユーザー名として使用します。

keyring set web-retrieval-mcp EXA_API_KEY
keyring set web-retrieval-mcp FIRECRAWL_API_KEY
keyring set web-retrieval-mcp TAVILY_API_KEY

認証情報はプロセスメモリ内に保持され、プロバイダーのエラーや表示される URL からは伏せられます。また、プロバイダーのコマンド引数に含まれることはありません。

設定リファレンス

設定デフォルト用途
EXA_API_KEY未設定Exa の検索とインデックス化されたページの内容
FIRECRAWL_API_KEY未設定Firecrawl によるフォールバック、研究論文、開発者向け検索
TAVILY_API_KEY未設定Tavily Search と Extract。tavily エクストラも必要です
WEB_SEARCH_PROVIDERexaweb_search のデフォルトプロバイダー:exa または tavily
WEB_FETCH_TAVILY_TIERfalse対象となる取得カスケードで Tavily Extract をグローバルに有効化します
WEB_RETRIEVAL_MCP_ENV_FILEプラットフォームのキー ファイルのパスdotenv キー ファイルの正確なパスを上書きします
WEB_RETRIEVAL_MCP_CONFIG_DIRプラットフォームの設定ディレクトリkeys.env を含むディレクトリを上書きします
WEB_RETRIEVAL_MCP_CACHEauto完了した取得結果のキャッシュ:auto、on、off
WEB_RETRIEVAL_MCP_VALKEY_SOCKET未設定プライベートな Valkey Unix ドメインソケットの絶対パス
WEB_RETRIEVAL_MCP_HOST127.0.0.1Streamable HTTP のバインドアドレス
WEB_RETRIEVAL_MCP_PORT8100Streamable HTTP のポート

ブール値の設定では 1/0、true/false、yes/no、on/off を使用できます。無効な値は推測されず、明示的にエラーになります。

完了結果キャッシュ(オプション)

cache エクストラをインストールし、プライベートで永続化されない Valkey Unix ドメインソケットをサーバーに指定します。

export WEB_RETRIEVAL_MCP_CACHE=on
export WEB_RETRIEVAL_MCP_VALKEY_SOCKET=/absolute/private/path/valkey.sock

対象となる取得が正常に完了すると、結果は 24 時間保存されます。認証情報を含む URL、userinfo、強制または正の鮮度指定、および render="always" の場合はキャッシュの再生をスキップします。キャッシュエラーが発生しても、通常のプロバイダー取得にフォールバックします。デフォルトの auto では、Valkey クライアントがインストールされており、かつ Windows 以外のホストの場合にのみキャッシュが有効になります。on は設定された Unix ソケットへの接続を試み、エラー時にはフォールバックします。off はキャッシュを無効にします。プライバシーモデル、singleflight の動作、最小限のサイドカー設定については、キャッシュガイドを参照してください。

Streamable HTTP トランスポート

stdio は、ローカル MCP クライアント向けのデフォルトかつ推奨されるトランスポートです。

web-retrieval-mcp
# equivalent: python -m web_retrieval_mcp

共有ローカルプロセスでは、ステートレスな Streamable HTTP を利用できます。

web-retrieval-mcp --http --host 127.0.0.1 --port 8100

HTTP トランスポートには認証機能が組み込まれていません。認証付きの境界と適切なネットワーク制御を追加しない場合は、ループバックに限定してください。

Claude Code の置き換えポリシー(オプション)

このパッケージには、Claude Code 組み込みの WebSearch と WebFetch を拒否し、代わりにエージェントがこの MCP サーバーを使うよう誘導する PreToolUse フックが含まれています。まず、変更される設定を正確にプレビューしてください。

web-retrieval-mcp-install --print

明示的にインストールまたは削除します。

web-retrieval-mcp-install
web-retrieval-mcp-install --register-mcp
web-retrieval-mcp-install --uninstall

インストーラーは冪等で、書き込み前に既存の設定ファイルをバックアップします。このオプションのフックは、パッケージ内で Claude Code に固有の唯一の統合機能です。MCP サーバー自体はクライアントに依存せず、このフックがなくても補完的なツールとして動作します。

ソースからインストール

レビュー済みのソースを直接インストールするには、次を実行します。

git clone https://github.com/VelvetSP/web-retrieval-mcp.git
cd web-retrieval-mcp
python -m pip install '.[all]'
python -m camoufox fetch

開発する場合:

python -m pip install -e '.[all,dev]'
./run-tests.sh

リリースゲートでは、wheel と sdist のアーティファクトをビルドし、クリーンな仮想環境に wheel をインストールしたうえで、ループバック上のプロバイダーのテスト用代替実装を使って、インストール済みの MCP コマンドをテストし、ユニットテストとトランスポートテストを実行します。ブラウザーや SSRF の動作を変更する場合は、python test_ssrf_redirect_live.py も実行する必要があります。機能マトリックスと受け入れ条件については、テスト仕様を参照してください。

セキュリティモデル

  • 最初の URL として受け付けるのは http と https のみです。
  • 最初のホストは、グローバルにルーティング可能なアドレスのみに解決される必要があります。
  • ローカルブラウザーはドキュメントリクエストを監視し、コンテンツを呼び出し元に返す前にリダイレクト先を検証します。
  • 認証情報はプロセス内で解決され、エラーおよび表示される URL から伏せられます。
  • プロバイダーの応答とページ本文は信頼できないデータです。エージェントは取得したコンテンツに埋め込まれた指示を権威あるものとして扱ってはなりません。

アプリケーションによるチェックでは、DNS リバインディング競合の間にプライベートアドレスへパケットが届かないことを証明できません。この脅威モデルに該当するデプロイでは、検証機能付きフォワードプロキシまたは同等のネットワーク送信ポリシーが必要です。セキュリティポリシーを参照し、脆弱性が疑われる場合は公開 issue ではなく、GitHub の非公開脆弱性報告からお知らせください。

よくある質問

web-retrieval-mcp とは何ですか?

AI エージェントに、信頼性の高いウェブ検索、段階的なウェブページ取得、研究論文の発見、開発者向けソース検索を提供するオープンソースの MCP サーバーです。互換性のある MCP クライアントであれば、ローカルの stdio 経由で利用でき、ステートレスな Streamable HTTP による提供にも対応しています。

これは MCP ウェブ検索サーバーですか、それとも MCP ウェブスクレイピングサーバーですか?

両方です。web_search はページを発見して順位付けし、web_fetch は 1 つの URL から読みやすいコンテンツを抽出します。また、JavaScript を多用するページには実際のローカルブラウザーを使用できます。通常のウェブスクレイピングでは利用できない、研究論文と開発者向けの専門インデックスも提供します。

エージェントに組み込まれたウェブ検索の代わりになりますか?

代わりにできますが、必ずしも置き換える必要はありません。2 つの取得システムを使うことで有用な情報源の多様性が得られるため、ツールの説明では、独立した補完的な検索経路の利用を推奨しています。Claude Code ユーザーは、経路を 1 つに統一したい場合、同梱の置き換えフックを選択できます。

どの AI エージェントと MCP クライアントで利用できますか?

このサーバーは、デフォルトで標準 MCP を stdio 経由で提供し、オプションで Streamable HTTP にも対応しています。ドキュメントに記載されているクライアントの例には、Codex CLI、Codex IDE 拡張機能、Claude Code、Claude Desktop、Cursor、ChatGPT デスクトップ版が含まれます。それ以外の MCP 対応エージェントも利用できます。互換性はクライアントのバージョンと対応している MCP トランスポートによって異なるため、上記のサーバーコマンドと併せて、該当するクライアントのドキュメントを参照してください。

Exa、Firecrawl、Tavily、Camoufox を併用する理由は何ですか?

それぞれ異なる失敗パターンに対応できるためです。Exa はインデックス検索とコンテンツ取得を提供し、Tavily は代替の検索プロバイダーおよびオプションの抽出機能として利用できます。Camoufox はページをローカルでレンダリングし、Firecrawl は最後のウェブフォールバックに加えて、研究論文と開発者向けの専門インデックスを提供します。サーバーはリクエストに応じてプロバイダーを選択し、成功した階層を明示します。

すべてのプロバイダーのキーが必要ですか?

いいえ。Exa は一般的な検索と第 1 階層のコンテンツ取得におけるデフォルトです。Firecrawl を設定すると、フォールバックと 4 つすべての研究論文関連ツールが利用可能になります。Tavily はオプションです。オプションの経路が設定されていない場合も、サーバーは 6 つすべてのツールを一覧に表示し、利用できない機能が選択された場合は、対処方法がわかるエラーを返します。

web-retrieval-mcp は無料ですか?

このプロジェクトは MIT ライセンスです。プロバイダーの利用料金は各自のアカウントに請求されます。各プロバイダーでは現在、初回利用向けの割り当てが提供されていますが、利用枠や価格は変更される場合があります。Camoufox は、従量制の取得 API を使わずにローカルで動作します。

対応している OS は何ですか?

基本となる Python サーバーはプラットフォームに依存しません。環境変数とキー ファイルによる認証情報は、Linux、macOS、Windows で利用できます。Valkey UDS キャッシュは Windows 以外に対応し、ローカルブラウザーの利用可否は、Camoufox/Playwright がサポートするプラットフォームに準じます。

RAG と自律型リサーチエージェントに対応していますか?

はい。ソースを分離した結果の契約、明示的な URL、調整可能なテキスト量、根拠に基づくページへの質問、専門分野別のインデックス、決定論的な出典情報により、これらのツールは RAG パイプラインやリサーチエージェントの検索レイヤーとして適しています。サーバーはエビデンスを返しますが、評価、引用、プロンプトインジェクションへの対応は呼び出し元のアプリケーションが担います。

プロジェクトリンク

コントリビューションを歓迎します。stdout は JSON-RPC 専用とし、診断情報は stderr に出力してください。動作を変更した場合は、公開境界の受け入れテストを追加し、 プルリクエストを作成する前に ./run-tests.sh を実行してください。

ライセンス

MIT © VelvetSP

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。