search-boost-mcp

Multi-Engine-Web-Suche MCP-Server für Coding-Agenten. Eine CLI-Installation bindet ihn in Cursor, Cursor CLI, Codex, Claude Code, Grok Build und Antigravity ein.

search-boost-Familie

Projekt	Für	Link
search-boost (dieses Repo)	Cursor · Codex · Claude · Grok · Antigravity via MCP	Sie sind hier
dsh-search-boost	DeepSeek Harness Bundle-Plugin	GitHub · npm
pi-search-boost	pi Erweiterung	GitHub · npm

Suchmaschinen sind in lib/search/ eingebunden (ursprünglich von dsh-search-boost): In der kostenlosen Schicht laufen Bing, DuckDuckGo, Yahoo und Exa-frei parallel; die api-Schicht fügt Antigravity CLI (wenn verfügbar) und beliebig viele tastaturgestütze Tavily-/Brave-/Exa-Engines hinzu, die Sie konfigurieren (ein Schlüssel reicht; alle drei werden für die beste Fusion empfohlen). Ebenfalls enthalten: X/Twitter-Fallback, Jina-Seitenabruf und Deep-Research-Durchläufe.

Chinesische Dokumentation → README_zh.md

Neu in v0.1.4

• Single-Engine-API-Schicht – die API-Stufe verwendet die von Tavily/Brave/Exa, die Sie konfigurieren oder aktivieren; es sind nicht alle drei Schlüssel erforderlich.

• Pro-Engine-Routing – optionale enabledEngines oder pro-Engine enabled: false in ~/.search-boost-keys.json.

• Teilschlüssel-Meldungen – doctor, status, keys-Wizard und fused_search warnen, wenn weniger als drei schlüsselbasierte Engines aktiv sind, und empfehlen, alle drei zu konfigurieren.

Neu in v0.1.2

• Eigenständiger Engine-Pool in lib/search/: Bing + DuckDuckGo + Yahoo + Exa-frei für allgemeine Suche; derselbe Pool versorgt den x_search-Fallback mit site:-Abfragen.

• x_search-Fallback fügt automatisch site:x.com für die Domainensuche über mehrere Engines hinzu, sodass der Schlüsselwortmodus ohne XAI-Anmeldeinformationen funktioniert.

• Keine externe dsh-Repo- oder npm-Abhängigkeit – die Engine-Logik ist in diesem Repository enthalten.

Installation (empfohlen)

Erfordert 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

Starten Sie jeden Agenten nach der Installation neu, damit MCP neu geladen wird.

Einzeiler nach 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

Vorschau ohne Schreiben: search-boost install --dry-run -y

Installation überprüfen

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 fehlerfrei · 1 Fehler (oder Warnungen mit --strict) · 2 nur Warnungen.

Optional: search-boost doctor --probe fügt einen Live-Such-Smoke-Test hinzu (benötigt Netzwerk; Phase 2).

Dann bestätigen Sie in Ihrem Agent:

Wenn Tools erscheinen, Aufrufe jedoch fehlschlagen, führen Sie search-boost serve in einem Terminal aus, um Startfehler zu sehen.

Installations-Flags (Kurzreferenz)

Für die vollständige Erstkonfiguration (API-Schlüssel + Ebenenauswahl) führen Sie search-boost setup oder search-boost install ohne -y aus.

Related MCP server: gemini-search-mcp

Was Sie erhalten

Auch: Ressource search-boost://policy · Prompt search_routing

Ebenen

• free – Bing + DuckDuckGo + Yahoo + Exa-frei; keine API-Schlüssel.

• api – Engines der Kostenlos-Stufe plus Antigravity CLI (wenn verfügbar) und beliebige von Tavily / Brave / Exa, die Sie konfigurieren (ein Schlüssel funktioniert; alle drei für die beste Cross-Engine-Fusion empfohlen)

Schlüssel: search-boost config keys → ~/.search-boost-keys.json (Legacy ~/.dsh-search-boost-keys.json wird weiterhin gelesen; oder env TAVILY_API_KEY, BRAVE_API_KEY, EXA_API_KEY). Optionales Routing: enabledEngines: ["exa"] oder "engines": { "brave": { "enabled": false } } in der Schlüsseldatei.

Schlüssel erhalten: Tavily · Brave Search API · Exa

X/Twitter-Authentifizierung (optional): Verbessert die offizielle x_search, wenn Anmeldeinformationen vorhanden sind. Gespeichert in ~/.search-boost-xauth.json (Legacy ~/.dsh-search-boost-xauth.json wird weiterhin gelesen) oder via XAI_API_KEY / Grok /x-login. Dateipfad überschreiben: SEARCH_BOOST_XAUTH_FILE.

Konfigurationsdatei-Überschreibungen: SEARCH_BOOST_KEYS_FILE, SEARCH_BOOST_LAYER_FILE, SEARCH_BOOST_XAUTH_FILE (optionale Umgebungsvariablen, die auf benutzerdefinierte Pfade verweisen).

CLI-Spickzettel

Installations-Flags: -t cursor,codex,…|auto|all · -y (nicht-interaktiv; impliziert --auto-allow + --replace-native) · --dry-run · --auto-allow (MCP-Tools vorab genehmigen – siehe Tabelle oben) · --replace-native / --keep-native · --scope user|project (Grok) · --workspace (Antigravity .agents/)

Unterstützte Agenten

Prompts verwenden Ermessensspielraum-des-Modells-Formulierungen (Suche, wenn Sie sich entscheiden – nicht bei jedem Zug erzwungen). Siehe agents/ für agentspezifische Vorlagen.

Native Websuche: Codex web_search und Claude WebSearch können mit --replace-native deaktiviert werden (Standard im nicht-interaktiven Modus). Cursor / Antigravity verlassen sich nur auf Skill- und Hook-Präferenz. Grok Native-Browsen bleibt eingeschaltet.

Antigravity + agy CLI: Auf der api-Ebene tritt die optionale Antigravity-CLI-Engine (agy im PATH) nur in den mittleren und komplexen fused_search-Stufen auf – nicht bei einfachen Suchvorgängen. Sie ist von einer lokalen Anmeldung und dem Plattform-Kontingent abhängig; Timeouts betragen ca. 45 s.

Grok-Plugin

Das Plugin wird im npm-Paket ausgeliefert (MCP per portablem npx, plus Skill).

Eine erneute Installation ist idempotent: search-boost install -t grok entfernt vor dem Schreiben eines neuen Blocks jeglichen vorherigen [permission]-Block von search-boost (markiert oder veraltet), sodass doppelte [permission]-Schlüssel den Start von grok nicht beeinträchtigen können. Wenn [ui] permission_mode = "always-approve" bereits gesetzt ist, überspringt --auto-allow das Einfügen von [permission] (always-approve genehmigt MCP-Tools global). search-boost doctor warnt vor doppelten oder redundanten Berechtigungsblöcken.

Aus einem Git-Clone (Repository-Stamm):

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

Nach npm install -g search-boost-mcp (kein Clone erforderlich):

# 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

Die gebündelte .mcp.json verwendet npx -y search-boost-mcp serve, sodass das Plugin auf jedem Rechner mit Node ≥ 22.13 funktioniert.

Details → grok-plugin/README.md

Fehlerbehebung

Entwicklung

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

Lokale Clone-Installationen schreiben node /path/to/cli.mjs serve (nicht npx). Es ist kein paralleles Checkout oder SEARCH_BOOST_DSH_ROOT erforderlich.

Lizenz

MIT

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

Freundlicher Link: LINUX DO 社区