search-boost-mcp

面向编码智能体的多引擎网络搜索 MCP 服务器。一条 CLI 命令即可将其接入 Cursor、Cursor CLI、Codex、Claude Code、Grok Build 和 Antigravity。

search-boost 系列

项目	适用对象	链接
search-boost (本仓库)	Cursor · Codex · Claude · Grok · Antigravity（通过 MCP）	你在这里
dsh-search-boost	DeepSeek Harness 捆绑插件	GitHub · npm
pi-search-boost	pi 扩展	GitHub · npm

搜索引擎已内置于 lib/search/（最初来自 dsh-search-boost）：在 免费 层，Bing、DuckDuckGo、Yahoo 和 Exa-free 并行运行；API 层则额外添加 Antigravity CLI（可用时）以及 你配置的任何带密钥的 Tavily / Brave / Exa 引擎（一个密钥即可；推荐全部三个以获得最佳融合效果）。此外还包括：X/Twitter 回退、Jina 页面抓取和深度研究轮次。

中文文档 → README_zh.md

v0.1.4 新特性

• 单引擎 API 层 — API 层使用你配置或启用的任意一个 tavily/brave/exa 引擎；无需全部三个密钥。

• 按引擎路由 — 可在 ~/.search-boost-keys.json 中设置可选的 enabledEngines 或按引擎设置 enabled: false。

• 部分密钥提示 — doctor、status、keys 向导和 fused_search 会在少于三个带密钥引擎激活时发出警告，并建议配置全部三个。

v0.1.2 新特性

• 自包含引擎池 位于 lib/search/：Bing + DuckDuckGo + Yahoo + Exa-free 用于通用搜索；同一引擎池通过 site: 查询为 x_search 回退提供支持。

• x_search 回退 自动为多引擎域名搜索添加 site:x.com 前缀，因此无需 XAI 凭据即可使用关键词模式。

• 无外部 dsh 仓库或 npm 依赖 — 引擎逻辑已内置于本仓库。

安装（推荐）

需要 Node ≥ 22.13。

npm install -g search-boost-mcp
search-boost setup          # interactive: keys → layer → agents
# or non-interactive:
search-boost install -y     # all detected agents

安装后请重启每个智能体，以便 MCP 重新加载。

按智能体的一键安装命令

search-boost install -t cursor -y
search-boost install -t codex,claude -y --auto-allow
search-boost install -t grok -y --auto-allow
search-boost install -t antigravity --workspace --auto-allow -y

预览而不写入：search-boost install --dry-run -y

验证安装

search-boost doctor          # health checks (offline, pass/warn/fail)
search-boost doctor --json   # machine-readable report for CI/scripts
search-boost status          # install dashboard (keys, layer, agents)

退出码：0 健康 · 1 失败（或使用 --strict 时的警告） · 2 仅警告。

可选：search-boost doctor --probe 会添加实时搜索冒烟测试（需要网络；第二阶段）。

然后在你的智能体中确认：

如果工具出现但调用失败，请在终端中运行 search-boost serve 查看启动错误。

安装标志（快速参考）

如需完整引导（API 密钥 + 层选择），请运行 search-boost setup 或 search-boost install（不带 -y）。

Related MCP server: gemini-search-mcp

你将获得

此外还有：资源 search-boost://policy · 提示 search_routing

层

• free — Bing + DuckDuckGo + Yahoo + Exa-free；无需 API 密钥。

• api — free 层引擎加上 Antigravity CLI（可用时）以及任意你配置的 Tavily / Brave / Exa（一个密钥即可；推荐全部三个以获得最佳跨引擎融合效果）

密钥：search-boost config keys → ~/.search-boost-keys.json（仍会读取旧版 ~/.dsh-search-boost-keys.json；或环境变量 TAVILY_API_KEY、BRAVE_API_KEY、EXA_API_KEY）。可选路由：在密钥文件中设置 enabledEngines: ["exa"] 或 "engines": { "brave": { "enabled": false } }。

获取密钥：Tavily · Brave Search API · Exa

X/Twitter 认证（可选）： 当存在凭据时，可改进官方 x_search。存储在 ~/.search-boost-xauth.json（仍会读取旧版 ~/.dsh-search-boost-xauth.json）或通过 XAI_API_KEY / Grok /x-login 设置。覆盖文件路径：SEARCH_BOOST_XAUTH_FILE。

配置文件覆盖： SEARCH_BOOST_KEYS_FILE、SEARCH_BOOST_LAYER_FILE、SEARCH_BOOST_XAUTH_FILE（指向自定义路径的可选环境变量）。

CLI 速查表

安装标志： -t cursor,codex,…|auto|all · -y（非交互式；隐含 --auto-allow + --replace-native） · --dry-run · --auto-allow（预授权 MCP 工具 — 见上表） · --replace-native / --keep-native · --scope user|project（Grok） · --workspace（Antigravity .agents/）

支持的智能体

提示使用模型自行决定措辞（在你选择时搜索 — 而非每轮强制）。参见 agents/ 了解各智能体模板。

原生网络搜索： Codex web_search 和 Claude WebSearch 可通过 --replace-native 禁用（非交互式时默认）。Cursor / Antigravity 仅依赖 skill 和 hook 偏好。Grok 原生浏览保持开启。

反重力 + agy CLI： 在 api 层，可选的 Antigravity CLI 引擎（位于 PATH 中的 agy）仅加入 medium 和 complex 级别的 fused_search 层级，而不参与简单查找。它依赖于本地登录和平台配额；超时时间约为 45 秒。

Grok 插件

该插件随 npm 包一起发布（通过可移植的 npx 提供 MCP，加上技能）。

重新安装是幂等的： search-boost install -t grok 会在写入新的 [permission] 块之前删除任何已有的 search-boost [permission] 块（标记的或旧的），因此重复的 [permission] 键不会导致 grok 启动失败。如果已经设置了 [ui] permission_mode = "always-approve"，则 --auto-allow 会跳过注入 [permission]（always-approve 全局批准 MCP 工具）。search-boost doctor 会警告重复或冗余的权限块。

从 git 克隆（仓库根目录）：

grok plugin install ./grok-plugin --trust
search-boost install -t grok -y --auto-allow

在 npm install -g search-boost-mcp 之后（无需克隆）：

# bash / macOS / Linux
grok plugin install "$(npm root -g)/search-boost-mcp/grok-plugin" --trust

# Windows PowerShell
grok plugin install "$(npm root -g)\search-boost-mcp\grok-plugin" --trust

search-boost install -t grok -y --auto-allow

捆绑的 .mcp.json 使用 npx -y search-boost-mcp serve，因此该插件可在任何 Node.js ≥ 22.13 的机器上工作。

详情 → grok-plugin/README.md

故障排除

开发

git clone https://github.com/Mr-remon219/search-boost.git
cd search-boost && npm install
npm run check && npm run test:install && npm run smoke
node cli.mjs install --dry-run -y

本地克隆安装会写入 node /path/to/cli.mjs serve（而不是 npx）。不需要同级检出或 SEARCH_BOOST_DSH_ROOT。

许可

MIT

链接： Issues · dsh-search-boost · pi-search-boost

友情链接： LINUX DO 社区