[오픈 소스] Claude Code용 로컬 코드 검색 MCP 도구 'Semble' 공개 (grep+read 대비 토큰 98% 절감)
[Open Source] We built a local code search MCP for Claude Code that uses ~98% fewer tokens than grep+read
핵심 요약
Claude Code의 토큰 낭비를 획기적으로 줄여주는 로컬 코드 검색 MCP 서버 'Semble'이 공개되었습니다.
- 토큰 효율성 — grep+read 방식 대비 토큰 사용량을 평균 98% 절감함.
- 로컬 성능 — API 키나 GPU 없이 CPU 환경에서 250ms 내 인덱싱 및 1.5ms 내 검색 완료.
- 기술 스택 — 정적 임베딩, BM25, 코드 최적화 리랭킹 스택을 결합하여 높은 검색 품질 제공.
- 사용 편의성 — Claude Code에 즉시 추가 가능하며 로컬 및 원격 저장소 모두 검색 지원.
Claude Code로 대규모 코드베이스를 작업하다 보면 항상 같은 문제에 부딪혔습니다. Claude가 관련 코드를 찾을 때 grep, 전체 파일 읽기, 혹은 여러 하위 에이전트를 실행하는 방식에 의존하게 되는데, 이 과정에서 토큰이 엄청나게 소모되고 정작 중요한 코드를 놓치는 경우도 많았습니다. 이미 존재하는 솔루션들도 몇 가지 있었지만(저희도 벤치마크를 해봤습니다), 모두 속도가 너무 느리거나, API 키가 필요하거나, 품질이 만족스럽지 못하는 등의 문제가 있었습니다.
저희는 이 문제를 해결하기 위해 Semble을 만들었습니다. 이 도구는 Claude Code에 고품질 코드 검색 기능을 제공하는 로컬 MCP 서버입니다. 파일을 읽어서 관련 내용을 찾는 대신, 일치하는 코드 청크만 반환합니다. 평균적으로 grep+read 방식보다 토큰을 98% 적게 사용하며, 모든 저장소를 ~250ms 안에 인덱싱하고 ~1.5ms 안에 쿼리에 응답합니다. 이 모든 것은 CPU에서 처리됩니다. 정적 임베딩, BM25, 그리고 코드 최적화 리랭킹 스택을 조합하여 구현했습니다.
설치:
claude mcp add semble -s user -- uvx --from "semble[mcp]" semble
설치가 완료되면 Claude Code로 모든 저장소(로컬 및 원격)를 직접 검색할 수 있습니다. 완전히 로컬에서 작동하며 API 키, GPU, 무거운 의존성이 필요 없습니다.
저희는 Semble에 대해 광범위한 벤치마크를 수행했으며, 품질 면에서 저희가 테스트한 최고의 트랜스포머 하이브리드 모델 성능의 99%(NDCG@10 0.854)를 달성하면서도 속도는 약 200배 빠릅니다. 또한 grepai, probe, colgrep 등 기존 방식들과도 직접 비교했습니다. 피드백 주시면 감사하겠습니다!
링크:
