jcodemunch-mcp: 토큰 효율적인 MCP 서버로 AST 파싱을 통해 정확한 GitHub 소스 코드 검색

What it solves

AI 코딩 에이전트는 일반적으로 전체 파일을 열고 수천 줄의 관련 없는 코드를 스캔하여 토큰을 낭비하고 컨텍스트 창을 오염시킵니다. jCodeMunch는 에이전트가 필요한 특정 코드(함수, 클래스, 메서드 등)만 가져올 수 있는 구조화된 검색 시스템을 제공하여 기존의 grep-and-read 방식에 비해 평균 96%의 토큰 사용량을 줄입니다.

How it works

이 프로젝트는 Model Context Protocol (MCP) 서버를 구현하여 tree-sitter AST 파싱으로 코드베이스를 색인화합니다. 구조화된 심볼 메타데이터와 바이트 오프셋을 저장하여 소스 코드를 바이트 수준 precision으로 검색할 수 있게 합니다. 또한 경로 프리픽스를 인턴하고 목록을 태그된 CSV 행으로 패킹하는 컴팩트한 와이어 포맷 "MUNCH"를 특징으로 하여 에이전트로 전송되는 바이트 수를 더욱 줄입니다.

Who it’s for

MCP 호환 AI 코딩 어시스턴트(예: Claude Code, Cursor, Windsurf, VS Code, Continue)를 사용하는 개발자로서 AI 지출을 줄이고 컨텍스트 창 오염을 줄이며 리포지토리 탐색 속도를 높이려는 분들께 적합합니다.

Highlights

  • Extreme Token Efficiency: 벤치마크 결과 코드 읽기 토큰 사용량이 86~99% 감소했습니다.
  • Precise Symbol Retrieval: 파일을 전체적으로 읽지 않고도 함수, 클래스, 상수의 정확한 구현을 가져올 수 있습니다.
  • Advanced Structural Queries: 데드 코드 찾기, 테스트되지 않은 심볼 감지, git-diff를 심볼에 매핑, PageRank를 통한 아키텍처 중심성 분석 등을 위한 도구가 제공됩니다.
  • Broad Language Support: tree-sitter를 사용하여 70개 이상의 언어를 지원합니다.
  • Compact Output: 추가로 45.5%의 바이트를 절약하는 특수 와이어 와이어 포맷이 도구 응답에 적용됩니다.
  • Safety Preflights: 임포터, 참조, 런타임 증거를 기반으로 심볼 삭제 또는 편집이 안전한지 확인하는 도구가 제공됩니다.

Sources