개발자 Alex가 AI 코딩 에이전트에 코드베이스에 대한 세밀한 심볼 단위 접근 권한을 제공하는 모델 컨텍스트 프로토콜 서버인 SymbolPeek을 출시했다. 에이전트가 소스 파일 전체를 로드하는 대신 특정 정의나 호출자, 참조 정보만을 요청할 수 있게 함으로써 대규모 코드 분석 시 필요한 토큰 사용량을 대폭 절감한다. 특히 TypeScript Compiler API를 활용해 가져오기 별칭, 배럴 익스포트, 추론된 타입과 같은 복잡한 구조를 정밀하게 탐색한다.

실제 1,800줄 규모의 파일 테스트에서 SymbolPeek은 기존 65KB의 소스 파일을 모두 로드하는 대신 단 2KB의 데이터만으로 특정 함수를 검색했다. 실제 개발 환경의 누적 데이터에 따르면 총 162건의 요청을 처리하며 352,910줄의 코드와 약 6.4MB의 데이터를 불필요하게 읽는 상황을 방지했다. 개발자에 따르면 이는 약 1.61M 토큰을 절약한 수치이며, 기존 전체 파일 로딩 방식과 비교해 평균 95.7%의 컨텍스트 사용량 절감 효과를 거두었다.

TypeScript와 JavaScript 외에도 Rust, Python, Java, Go, JSON, Markdown을 지원한다. TypeScript는 컴파일러 기반 분석을 활용하고, 타 언어는 구문 중심의 빠른 탐색을 위해 Tree-sitter를 사용한다. 이 프로젝트는 대규모 파일에서 단순 심볼을 추출하던 비효율을 제거하여 AI 코딩 세션의 신호 대 잡음비를 높이는 것을 목표로 한다. 개발자는 SymbolPeek이 grep과 같은 표준 텍스트 검색 도구를 대체하는 것이 아니라, 호출 계층 및 진단 탐색 등 의미론적 이해가 필요한 작업에서 상호 보완적인 도구로 활용되길 기대한다.

개발자 Alex가 AI 코딩 에이전트에 코드베이스에 대한 세밀한 심볼 단위 접근 권한을 제공하는 모델 컨텍스트 프로토콜 서버인 SymbolPeek을 출시했다. 에이전트가 소스 파일 전체를 로드하는 대신 특정 정의나 호출자, 참조 정보만을 요청할 수 있게 함으로써 대규모 코드 분석 시 필요한 토큰 사용량을 대폭 절감한다. 특히 TypeScript Compiler API를 활용해 가져오기 별칭, 배럴 익스포트, 추론된 타입과 같은 복잡한 구조를 정밀하게 탐색한다.

실제 1,800줄 규모의 파일 테스트에서 SymbolPeek은 기존 65KB의 소스 파일을 모두 로드하는 대신 단 2KB의 데이터만으로 특정 함수를 검색했다. 실제 개발 환경의 누적 데이터에 따르면 총 162건의 요청을 처리하며 352,910줄의 코드와 약 6.4MB의 데이터를 불필요하게 읽는 상황을 방지했다. 개발자에 따르면 이는 약 1.61M 토큰을 절약한 수치이며, 기존 전체 파일 로딩 방식과 비교해 평균 95.7%의 컨텍스트 사용량 절감 효과를 거두었다.

TypeScript와 JavaScript 외에도 Rust, Python, Java, Go, JSON, Markdown을 지원한다. TypeScript는 컴파일러 기반 분석을 활용하고, 타 언어는 구문 중심의 빠른 탐색을 위해 Tree-sitter를 사용한다. 이 프로젝트는 대규모 파일에서 단순 심볼을 추출하던 비효율을 제거하여 AI 코딩 세션의 신호 대 잡음비를 높이는 것을 목표로 한다. 개발자는 SymbolPeek이 grep과 같은 표준 텍스트 검색 도구를 대체하는 것이 아니라, 호출 계층 및 진단 탐색 등 의미론적 이해가 필요한 작업에서 상호 보완적인 도구로 활용되길 기대한다.