search-boost-mcp

코딩 에이전트를 위한 다중 엔진 웹 검색 MCP 서버입니다. 하나의 CLI 설치로 Cursor, Cursor CLI, Codex, Claude Code, Grok Build, Antigravity에 연결됩니다.

search-boost 제품군

프로젝트	용도	링크
search-boost (이 저장소)	Cursor · Codex · Claude · Grok · Antigravity via 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는 라이브 검색 스모크 테스트를 추가합니다(네트워크 필요, 2단계).

그런 다음 에이전트에서 확인:

도구가 나타나지만 호출이 실패하면 터미널에서 search-boost serve를 실행하여 시작 오류를 확인하세요.

설치 플래그 (빠른 참조)

전체 온보딩(API 키 + 계층 선택)을 보려면 -y 없이 search-boost setup 또는 search-boost install을 실행하세요.

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 네이티브 브라우징은 켜진 상태로 둡니다.

Antigravity + agy CLI: api 레이어에서 선택적 Antigravity CLI 엔진(PATH 상의 agy)은 단순 조회가 아닌 중간 및 복잡 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 ≥ 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

링크: 이슈 · dsh-search-boost · pi-search-boost

친근한 링크: LINUX DO 커뮤니티