justrach/codedb

Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

해결하는 문제

codedb는 AI 에이전트를 위해 특별히 설계된 코드 인텔리전스 서버입니다. 단순히 원시 파일 읽기나 무차별 대입 검색에 의존하는 대신, 코드를 구조적 및 텍스트적으로 인덱싱하는 고성능 컨텍스트 엔진을 제공함으로써 에이전트가 대규모 코드베이스를 효율적으로 찾고 이해하는 데 어려움을 겪는 문제를 해결합니다.

작동 방식

외부 종속성 없이 Zig로 구축된 codedb는 시작 시 프로젝트의 포괄적인 인덱스를 생성합니다. 구조적 파싱(함수, 구조체 및 임포트용), 가속화된 전체 텍스트 검색을 위한 trigram 인덱스, 그리고 O(1) 식별자 조회를 위한 역색인 단어 인덱스를 결합하여 사용합니다. 폴링 파일 워처가 인덱스를 실시간으로 업데이트합니다. 이 인텔리전스는 Model Context Protocol (MCP) 및 HTTP 서버를 통해 노출되어, AI 에이전트가 파일 시스템을 다시 스캔하지 않고도 심볼, 종속성 및 개요를 쿼리할 수 있도록 합니다.

대상 사용자

정확도를 높이고 토큰 소비를 줄이기 위해 에이전트가 코드베이스 구조 및 심볼에 대해 깊고 낮은 지연 시간의 액세스를 갖추기를 필요로 하는 AI 에이전트(Claude Code, Cursor, Windsurf 또는 Devin 등) 사용자 개발자.

주요 특징

극한의 성능: 사전 인덱싱된 쿼리는 ripgrep 또는 grep과 같은 도구보다 수십 배 빠릅니다.
MCP 네이티브: 종속성 그래프 및 심볼 조회를 포함하여 에이전트가 코드를 탐색할 수 있는 21개의 전문화된 도구를 제공합니다。
토큰 효율성: 원시 라인 덤프 대신 구조화된 관련 결과를 반환하여 쿼리당 사용되는 토큰 수를 크게 줄입니다。
폭넓은 언어 지원: Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R 및 Dart에 대한 완전한 파서 지원.
클라우드 인텔리전스: codedb_remote 도구를 통해 에이전트는 로컬 클론 없이도 api.wiki.codes를 통해 인덱싱된 공개 GitHub 리포지토리를 쿼리할 수 있습니다.