TS 컴파일러로 만든 코드 그래프 MCP, Claude Code 토큰 10배 절감

기존의 MCP(Model Context Protocol) 기반 코드 그래프 도구들은 에이전트가 코드를 탐색하는 과정에서 과도한 토큰을 소비하거나, 오히려 토큰 사용량을 늘리는 문제가 있었습니다.

@ttsc/graph는 TypeScript 컴파일러를 직접 활용하여 코드의 구조적 관계(함수 호출, 임포트, 상속 등)를 인덱싱하는 방식을 채택했습니다. 이 도구는 소스 코드 전체를 전달하는 대신, 컴파일러가 생성한 노드와 엣지 형태의 그래프만을 제공하여 에이전트가 코드의 구조를 즉각적으로 파악하게 합니다.

주요 특징은 다음과 같습니다:

• 토큰 효율성: 소스 본문 대신 인덱스만 전달하므로, 리포지토리 크기와 관계없이 토큰 사용량이 일정하게 유지되며 기존 대비 약 10배의 토큰 절감 효과를 보였습니다.
• 정확도: TypeScript 컴파일러의 결과물을 기반으로 하므로 에이전트가 제공하는 정보의 신뢰도가 높으며, 모든 답변에 정확한 file:line 위치를 명시합니다.
• 사용 편의성: MIT 라이선스로 제공되며, 단 네 줄의 명령어로 설치가 가능합니다.

이 도구는 에이전트가 파일을 하나씩 열어보며 탐색(Spelunking)하는 대신, 지하철 노선도처럼 최적화된 그래프를 통해 코드의 흐름을 빠르게 이해하도록 돕습니다.