web-search

通过一个 MCP search 工具，为你的 AI Agent 提供覆盖 6 个引擎的网页搜索。托管服务。智能路由。缓存。

为什么选择 GroundRoute

• 一个工具，六个引擎。 Serper、Brave、Exa、Tavily、Firecrawl、Perplexity，都通过一次 search 调用完成。无需再接入六套 API、六个 SDK 和六个计费门户。
• 费用永不高于直接使用。 采用节省分成定价：每笔缓存节省的费用，你和 GroundRoute 各保留约一半。未命中缓存时，只需支付引擎费用。支持 BYOK。
• 默认启用路由、缓存和故障转移。 每个查询都会发送到能够达到质量门槛且价格最低的引擎。重复查询直接从缓存返回。如果某个引擎性能下降，我们会自动切换。无需更改 Agent 代码。

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 个真实 Agent 查询进行了评估，绘制了各类查询的成本与质量对比。完整的方法和各引擎结果请参阅：AI 搜索现状。

---

安装

托管端点为 https://api.groundroute.ai/mcp（streamable-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 服务（可选）

此仓库还提供了一个小型原生 stdio MCP 服务（server.py），可转发请求到托管 API，适用于仅支持 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	string	必填
mode	enum	auto（默认）、web、news、academic、answer、page
max_results	integer	默认值为 10，最大值为 50
freshness	enum	fresh、semi、static；省略时自动检测
domains	string[]	仅包含指定域名的筛选条件，例如 ["arxiv.org"]
lang	string	ISO 639-1 语言代码，例如 en
country	string	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 个真实 Agent 查询）。

链接

• 首页：https://groundroute.ai
• 获取密钥：https://groundroute.ai/keys
• 体验场（无需安装即可试用）：https://groundroute.ai/playground
• 文档：https://groundroute.ai/docs/mcp-server

此仓库中的 registry-manifest.json 是 MCP 注册表的列表清单。