search-boost-mcp

Multi-engine web search MCP server for coding agents. One CLI install wires it into Cursor, Cursor CLI, Codex, Claude Code, Grok Build, and Antigravity.

search-boost family

Project	For	Link
search-boost (this repo)	Cursor · Codex · Claude · Grok · Antigravity via MCP	you are here
dsh-search-boost	DeepSeek Harness bundle plugin	GitHub · npm
pi-search-boost	pi extension	GitHub · npm

Search engines are vendored in lib/search/ (originally from dsh-search-boost): on the free layer, Bing, DuckDuckGo, Yahoo, and Exa-free run in parallel; the api layer adds Antigravity CLI (when available) and whichever keyed Tavily / Brave / Exa engines you configure (one key is enough; all three recommended for best fusion). Also included: X/Twitter fallback, Jina page fetch, and deep-research rounds.

中文文档 → README_zh.md

What's new in v0.1.4

• Single-engine api layer — api tier uses whichever of tavily/brave/exa you configure or enable; no need for all three keys.

• Per-engine routing — optional enabledEngines or per-engine enabled: false in ~/.search-boost-keys.json.

• Partial-key messaging — doctor, status, keys wizard, and fused_search warn when fewer than three keyed engines are active and recommend configuring all three.

What's new in v0.1.2

• Self-contained engine pool in lib/search/: Bing + DuckDuckGo + Yahoo + Exa-free for general search; same pool powers x_search fallback with site: queries.

• x_search fallback auto-prepends site:x.com for multi-engine domain search so keyword mode works without XAI credentials.

• No external dsh repo or npm dependency — engine logic is vendored in this repository.

Install (recommended)

Requires 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

Restart each agent after install so MCP reloads.

One-liners by agent

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

Preview without writing: search-boost install --dry-run -y

Verify install

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)

Exit codes: 0 healthy · 1 failure (or warnings with --strict) · 2 warnings only.

Optional: search-boost doctor --probe adds live search smoke (needs network; Phase 2).

Then confirm in your agent:

If tools appear but calls fail, run search-boost serve in a terminal to see startup errors.

Install flags (quick reference)

For full onboarding (API keys + layer choice), run search-boost setup or search-boost install without -y.

Related MCP server: gemini-search-mcp

What you get

Also: resource search-boost://policy · prompt search_routing

Layers

• free — Bing + DuckDuckGo + Yahoo + Exa-free; no API keys.

• api — free-layer engines plus Antigravity CLI (when available) and any of Tavily / Brave / Exa that you configure (one key works; all three recommended for best cross-engine fusion)

Keys: search-boost config keys → ~/.search-boost-keys.json (legacy ~/.dsh-search-boost-keys.json still read; or env TAVILY_API_KEY, BRAVE_API_KEY, EXA_API_KEY). Optional routing: enabledEngines: ["exa"] or "engines": { "brave": { "enabled": false } } in the keys file.

Obtain keys: Tavily · Brave Search API · Exa

X/Twitter auth (optional): improves official x_search when credentials are present. Stored at ~/.search-boost-xauth.json (legacy ~/.dsh-search-boost-xauth.json still read) or via XAI_API_KEY / Grok /x-login. Override file path: SEARCH_BOOST_XAUTH_FILE.

Config file overrides: SEARCH_BOOST_KEYS_FILE, SEARCH_BOOST_LAYER_FILE, SEARCH_BOOST_XAUTH_FILE (optional env vars pointing at custom paths).

CLI cheat sheet

Install flags: -t cursor,codex,…|auto|all · -y (non-interactive; implies --auto-allow + --replace-native) · --dry-run · --auto-allow (pre-approve MCP tools — see table above) · --replace-native / --keep-native · --scope user|project (Grok) · --workspace (Antigravity .agents/)

Supported agents

Prompts use model-discretion wording (search when you choose — not forced every turn). See agents/ for per-agent templates.

Native web search: Codex web_search and Claude WebSearch can be disabled with --replace-native (default when non-interactive). Cursor / Antigravity rely on skill + hook preference only. Grok native browse is left on.

Antigravity + agy CLI: On the api layer, the optional Antigravity CLI engine (agy on PATH) joins medium and complex fused_search tiers only — not simple lookups. It depends on local sign-in and platform quota; timeouts are ~45s.

Grok plugin

The plugin ships inside the npm package (MCP via portable npx, plus skill).

Re-install is idempotent: search-boost install -t grok removes any prior search-boost [permission] block (marked or legacy) before writing a fresh one, so duplicate [permission] keys cannot break grok startup. If [ui] permission_mode = "always-approve" is already set, --auto-allow skips injecting [permission] (always-approve approves MCP tools globally). search-boost doctor warns on duplicate or redundant permission blocks.

From a git clone (repo root):

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

After npm install -g search-boost-mcp (no clone needed):

# 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

The bundled .mcp.json uses npx -y search-boost-mcp serve so the plugin works on any machine with Node ≥ 22.13.

Details → grok-plugin/README.md

Troubleshooting

Development

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

Local clone installs write node /path/to/cli.mjs serve (not npx). No sibling checkout or SEARCH_BOOST_DSH_ROOT is required.

License

MIT

Links: Issues · dsh-search-boost · pi-search-boost

Friendly link: LINUX DO 社区