web-search

AI エージェントに、6 つのエンジンを横断するウェブ検索を1 つの MCP search ツールで提供します。ホスト型。ルーティング。キャッシュ。

GroundRoute を選ぶ理由

• 1 つのツールで 6 つのエンジン。 Serper、Brave、Exa、Tavily、Firecrawl、Perplexity を、単一の search 呼び出しで利用できます。6 つの API、6 つの SDK、6 つの課金ポータルを個別につなぎ込む必要はありません。
• 直接利用より高くなることはありません。 利益分配型の料金設定です。キャッシュによる節約分の約半分はお客様に、約半分は GroundRoute に還元されます。キャッシュミス時は、検索エンジンの料金のみをお支払いいただきます。BYOK に対応しています。
• ルーティング、キャッシュ、フェイルオーバーはすべて標準で有効です。 各クエリは品質基準を満たす最安のエンジンに送られます。同じクエリはキャッシュから返されます。エンジンの性能が低下した場合は、自動的にフォールバックします。エージェントのコードを変更する必要はありません。

動作を確認する（5 秒）

search ツールの呼び出し：

{
  "name": "search",
  "arguments": { "query": "what is RAGflow", "max_results": 3 }
}

レスポンス（一部抜粋）：

{
  "results": [
    {
      "url": "https://ragflow.io/docs/",
      "title": "Quickstart - RAGFlow",
      "snippet": "RAGFlow is an open-source RAG engine based on deep document understanding...",
      "source_engine": "serper"
    },
    {
      "url": "https://github.com/infiniflow/ragflow",
      "title": "RAGFlow is a leading open-source Retrieval-Augmented Generation engine",
      "snippet": "RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine...",
      "source_engine": "serper"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "cache_tier": "miss",
    "degraded": false,
    "cost_usd": 0.0021
  }
}

source_engine で応答したエンジンがわかります。meta にはキャッシュ層と呼び出しごとの請求額が表示されます。

リリースだけでなく、ベンチマークも実施

LLM による評価を用いて、6 つすべてのエンジンでエージェントの実際のクエリを 170 件実行し、クエリの種類ごとにコストと品質の関係を調査しました。詳しい方法とエンジンごとの結果は、AI 検索の現状をご覧ください。

---

インストール

ホスト型エンドポイントは https://api.groundroute.ai/mcp（ストリーミング可能な HTTP）です。groundroute.ai/keys で API キーを取得してください。

Claude Desktop / Claude Code の場合、MCP 設定に追加します：

{
  "mcpServers": {
    "groundroute": {
      "type": "http",
      "url": "https://api.groundroute.ai/mcp",
      "headers": { "Authorization": "Bearer gr_YOUR_KEY" }
    }
  }
}

Cursor の場合、~/.cursor/mcp.json：

{ "mcpServers": { "groundroute": { "url": "https://api.groundroute.ai/mcp",
  "headers": { "Authorization": "Bearer gr_YOUR_KEY" } } } }

VS Code（ネイティブ MCP / Continue）の場合、.vscode/mcp.json：

{ "servers": { "groundroute": { "type": "http", "url": "https://api.groundroute.ai/mcp",
  "headers": { "Authorization": "Bearer gr_YOUR_KEY" } } } }

ローカル / stdio 専用クライアントの場合、mcp-remote で stdio を HTTP にブリッジします：

{ "mcpServers": { "groundroute": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://api.groundroute.ai/mcp", "--header", "Authorization:Bearer gr_YOUR_KEY"]
} } }

このリポジトリの stdio サーバーを実行する（任意）

このリポジトリには、ホスト型 API に転送する小型のネイティブ stdio MCP サーバー（server.py）も含まれています。stdio 専用クライアントやコンテナ環境での実行に便利です。

pip install -r requirements.txt
GROUNDROUTE_API_KEY=gr_YOUR_KEY python server.py

Docker を使う場合：

docker build -t groundroute-mcp .
docker run -i -e GROUNDROUTE_API_KEY=gr_YOUR_KEY groundroute-mcp

イントロスペクション（ツールの検出）はキーなしで実行できます。検索の実行には GROUNDROUTE_API_KEY が必要です（https://groundroute.ai/keys で取得できます）。

search ツール

パラメーター	型	備考
query	文字列	必須
mode	列挙型	auto（デフォルト）、web、news、academic、answer、page
max_results	整数	デフォルト 10、最大 50
freshness	列挙型	fresh、semi、static。省略すると自動検出
domains	文字列[]	対象ドメインのみを含めるフィルター。例：["arxiv.org"]
lang	文字列	ISO 639-1 言語コード。例：en
country	文字列	ISO 3166-1 alpha-2 国コード。例：us

構造化された結果を返します。順位付けされた results（url / title / snippet / content / source_engine / published_at）、任意で生成される answer と citations（answer モード）、および meta（request_id / cache_tier / degraded / cost_usd）が含まれます。ルーティング、キャッシュに対応し、安定して動作します。

仕組み

複数の検索エンジンの前段に単一のエンドポイントを設け、価格に基づくルーティング、キャッシュ、フェイルオーバー、利用状況のガバナンスを実現します。ドキュメントとAI 検索の現状のベンチマーク（6 つすべてのエンジンでエージェントの実際のクエリを 170 件）をご覧ください。

リンク

• ホームページ：https://groundroute.ai
• キーの取得：https://groundroute.ai/keys
• プレイグラウンド（インストールせずにお試しいただけます）：https://groundroute.ai/playground
• ドキュメント：https://groundroute.ai/docs/mcp-server

このリポジトリの registry-manifest.json は、MCP レジストリ向けの一覧マニフェストです。