Claude에게 grep 대신 토큰 예산이 설정된 컨텍스트 번들을 전달하는 MCP 서버 및 Claude Code 스킬 구축

Anthropic 자체의 하네스 가이드라인(harness guidance)은 에이전트가 코드를 찾기 위해 grep/glob을 사용하도록 유도합니다. 이는 작동은 하지만 토큰 소모가 매우 큽니다. grep은 거의 완벽한 재현율(recall)을 얻지만, 매칭된 항목 주변의 모든 것을 가져오기 때문에 토큰 효율성은 거의 제로에 가깝습니다. archex는 검색 단계를 적절히 수행하고 Claude에게 완성된 번들을 전달하는 로컬 MCP 서버입니다. 이 번들은 사용자가 설정한 토큰 예산 내에서 순위가 매겨지고, 중복이 제거되며, 의존성이 닫힌(dependency-closed) 상태로 제공됩니다. 그러면 Claude는 임포트(import)를 탐색하는 대신 추론(reasoning)에 컨텍스트를 사용합니다. Claude Code를 위해 구체적으로 연결된 기능은 다음과 같습니다: MCP 서버 (stdio, 14개 도구): query, scout, analyze, compare, symbol lookup, graph neighbors/path/stats. 선택적인 --watch 모드는 편집하는 동안 인덱스를 최신 상태로 유지합니다. 리포지토리 내 스킬(In-repo skill) + /archex 명령어를 통해 터미널로 나가지 않고도 세션 내부에서 쿼리/스카우트(query/scout)를 수행할 수 있습니다. scout 프로토콜: 2단계인 map → fetch 흐름입니다. 토큰 예산으로 제한되어 구조적 맵(structural map)과 정확한 fetch 핸들을 반환하므로, 에이전트는 실제로 필요한 본문(bodies)만 가져옵니다. archex doctor: 결과가 오래된 것처럼 보일 때 인덱스 상태, 문법 지원, 모델 캐시 및 MCP 등록을 확인합니다. 완전히 로컬이며, 결정론적(deterministic)이고, API 키가 필요 없으며, Apache 2.0 라이선스입니다. 가장 가까운 오픈 소스(OSS) 도구와의 직접 비교: 에이전트가 작업을 완료하는 데 필요한 추가 토큰이 archex 번들을 사용했을 때는 922개였던 반면, 해당 도구를 사용했을 때는 11,188개였습니다 (~12배 차이). submitted by /u/tom_mathews [link] [comments]