SymDex: 오픈소스 MCP 코드 인덱서로 AI 에이전트 토큰 97% 절감

SymDex의 역할

SymDex는 현재 AI 코딩 에이전트의 특정 문제를 해결합니다: 함수를 찾으라는 요청을 받으면, 일반적으로 해당 함수가 포함된 전체 파일을 읽어서 실제 작업을 시작하기도 전에 컨텍스트 창 토큰을 소모해버립니다. 개발자가 SymDex를 만든 이유는 사용했던 모든 AI 에이전트가 단 하나의 함수를 찾기 위해 전체 파일을 읽고 있었기 때문입니다.

토큰 계산

원자료에 따르면, 300줄짜리 파일에는 약 10,500개의 문자가 포함됩니다. 주요 LLM에서 사용되는 BPE 토크나이저가 대략 3-4개의 문자를 하나의 토큰으로 처리한다고 할 때, 코드 자체는 약 3,000 토큰, 여기에 들여쓰기 공백과 응답 프레이밍을 더하면 하나의 함수를 조회하는 데 약 3,400 토큰이 소요됩니다. 실제 디버깅 세션에서는 8-10개의 파일을 건드릴 수 있어, 수정 작업을 시작하기도 전에 컨텍스트 창의 대부분을 소모하게 됩니다.

작동 방식

SymDex는 코드베이스를 한 번 사전 인덱싱합니다. 인덱싱 후에는 에이전트가 전체 파일을 읽지 않고도 모든 함수와 클래스의 정확한 위치를 알게 됩니다. 읽는 데 약 3,400 토큰이 소요되던 300줄짜리 파일이 SymDex를 사용하면 약 100 토큰으로 결과를 반환합니다.

추가 기능으로는:

로컬 시맨틱 검색 (함수 이름뿐만 아니라 기능으로 함수 찾기)
호출 그래프 추적을 통해 에이전트가 무언가를 건드리기 전에 무엇이 깨질지 알 수 있음

시작하기

설치 및 기본 사용법:

pip install symdex
symdex index ./your-project --name myproject
symdex search "validate email"

호환성 및 라이선스

SymDex는 Claude, Codex, Gemini CLI, Cursor, Windsurf 및 모든 MCP 호환 에이전트와 함께 작동합니다. 또한 독립 실행형 CLI도 제공합니다. 이 도구는 무료이며 MIT 라이선스를 따르고, 완전히 사용자의 기기에서 실행됩니다. 12개의 프로그래밍 언어를 지원합니다.

📖 전체 원문 읽기: r/ClaudeAI