Semble: 클로드 코드용 로컬 MCP 서버, 토큰 98% 절감

Semble은 MCP 서버로, Claude Code가 로컬 코드베이스를 효율적으로 검색할 수 있게 해주며, 전체 파일 대신 관련 코드 청크만 반환합니다. 정적 임베딩, BM25, 코드에 최적화된 재순위화 스택을 하이브리드로 사용하며, 모두 로컬 CPU에서 실행됩니다. API 키, GPU, 무거운 종속성이 필요 없습니다.

설치

uvx를 통해 설치합니다:

claude mcp add semble -s user -- uvx --from "semble[mcp]" semble

설치가 완료되면 Claude Code가 로컬 또는 원격 리포지토리를 직접 검색할 수 있습니다.

주요 특징

• 토큰 감소: 일반적인 grep+read 방식보다 약 98% 적은 토큰을 사용합니다.
• 성능: 리포지토리를 약 250ms에 인덱싱하고, 쿼리를 약 1.5ms에 응답합니다 (모두 CPU에서).
• 품질: NDCG@10 0.854 달성 — 테스트된 최고의 트랜스포머 하이브리드의 99% 성능을 내면서 약 200배 빠릅니다.
• 벤치마크 비교: grepai, probe, colgrep 등 기존 방법과 비교했습니다.
• 오픈소스: MinishLab 조직의 GitHub에서 사용할 수 있습니다.

대상 사용자

대규모 코드베이스에서 Claude Code를 사용하며, 외부 API 호출 없이 고품질 코드 검색 결과를 얻으면서 토큰 소모와 지연 시간을 줄이려는 개발자.