Agent Search MCP
先找到来源,再把证据带回来。
Agent Search MCP 是一个开源的 MCP 网页搜索路由器,默认无需搜索 API Key,直接检索中文与英文网页。搜索来源、付费权限和返回长度,都应该能控制。Agent Search MCP 把这些选择收进同一个搜索入口。
本文目录
一次查询,同时说明边界。

搜索意图 · 示例
查询 · 语言 · 来源策略 · 预算
查中文技术资料,优先免费来源,控制返回内容的长度。
返回路径
来源 → 去重 → 可追溯结果
读结果时能回到来源,也能查看来源失败与路由决策。
如何工作
给需要联网查证的 Agent
带着边界提出查询
语言、来源策略,以及调用、时间和证据预算。
整理为可追溯的证据
合并、去重,在证据预算内保留相关内容与来源。
读结果、追溯原文,也能检查失败与路由决策。
Token 数据来自可重放 fixture。
仓库用锁定 tokenizer 重放同一组双语结果,只比较输出格式对上下文体积的影响。
| 输出 | 每次查询平均 Token | 相对 Normal |
|---|---|---|
| Normal | 2311.0 | 基线 |
| Compact | 1655.8 | 28.4% |
| Compact+ | 1607.5 | 30.4% |
这组数据验证格式和证据包行为,不代表实时引擎可用率、搜索准确率或所有查询的固定节省比例。
安装与支持
默认配置只走零密钥来源。你可以先接入 MCP 客户端,再按需要配置商业 Provider、HTTP 模式或持久缓存。
需要 Node.js 18.17 或更高版本。默认运行不需要 Python。
npx -y agent-search-mcp{
"mcpServers": {
"agent-search": {
"command": "npx",
"args": ["-y", "agent-search-mcp"]
}
}
}常见问题
Agent Search MCP 需要 API Key 吗?
不需要。默认的 8 个来源可以零密钥启动。Brave、Tavily、Exa 与 You.com 只在你配置凭证并选择允许它们的路由策略后使用。
它可以替代 Tavily 或 Exa 吗?
它适合免费优先、自托管和多源证据场景。商业搜索 API 在稳定性、专有索引或语义能力上仍有优势,因此项目把它们保留为可控升级路径。
默认运行需要 Python 吗?
不需要。默认搜索运行在 Node.js 上。只有可选的语义去重和重排能力会使用 Python 与 Model2Vec。
它怎样减少 Agent 的上下文消耗?
Compact 输出保留前部完整结果,把后续结果收敛为带来源的引用,并用统一证据预算限制查询相关片段的总长度。
HTTP 模式默认安全吗?
HTTP 与 both 模式默认要求 Bearer Token;带 Origin 的浏览器请求还要命中 allowlist。stdio 仍是最简单的本地接入方式。
接着读
被 You.com 选中的 MCP 搜索服务器:一次意外的市场验证
免费 Tavily 替代:用 Agent Search MCP 做 AI 网页搜索