codebase-memory-mcp

codebase-memory-mcp은 Model Context Protocol(MCP)을 통해 AI 코딩 에이전트에 서비스를 제공하는 코드 인텔리전스 엔진입니다. 코드베이스를 함수, 클래스, 호출 체인, HTTP 라우트, 크로스 서비스 링크의 영속적 지식 그래프로 파싱한 후, 해당 그래프에 대한 구조적 쿼리에 응답합니다. 주요 특징: - 인덱싱: tree-sitter AST 분석은 바이너리에 컴파일된 162개의 버번드 구문 분석기를 사용합니다. RAM 중심 파이프라인은 LZ4 압축, 인메모리 SQLite, Aho-Corasick 패턴 매칭을 활용합니다. README는 리눅스 커널(2800만 LOC, 7만5천 파일)을 약 3분 만에 인덱싱했다고 보고합니다. - 하이브리드 LSP: Python, TypeScript/JavaScript/JSX/TSX, PHP, C#, Go, C, C++, Java, Kotlin, Rust, Perl에 대한 타입 해결 알고리즘의 경량 C 구현으로, 매개변수 바인딩, 반환 타입 추론, 제네릭 치환 및 언어별 해결 패턴을 다룹니다. - 쿼리 표면: 아키텍처 개요, 호출 그래프 추적, 영향 분석, 데드 코드 감지, Cypher 유사 그래프 쿼리, 의미론적 검색, BM25 전체 텍스트 검색, 코드 검색을 포함한 15개 MCP 도구를 제공합니다. README는 서브밀리초 구조 쿼리와 파일 단위 탐색 대비 토큰 감소를 보고합니다. - 그래프 모델: CALLS, IMPORTS, DEFINES, IMPLEMENTS, INHERITS, HTTP_CALLS, EMITS, LISTENS_ON, DATA_FLOWS, SIMILAR_TO, SEMANTICALLY_RELATED 등의 엣지 유형을 사용합니다. 크로스 리포지토리 CROSS_* 엣지는 동일한 스토어의 리포지토리 간 노드를 연결합니다. - 인프라스트럭처어코드: Dockerfiles, Kubernetes 매니페스트, Kustomize 오버레이는 서로 참조되는 그래프 노드로 인덱싱됩니다. - 배포: macOS, Linux, Windows용 단일 네이티브 실행 파일로, 언어 런타임, 호스팅 서비스, API 키가 필요하지 않습니다. 또한 npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR, go install를 통해서도 제공됩니다. 모든 처리는 로컬에서 이루어집니다. - 동작: 설치 명령은 지원되는 코딩 에이전트를 자동으로 감지하고 구성합니다. 공유 조정 데몬은 백그라운드 워쳐, 인덱싱 작업, 선택적 UI를 관리합니다. 자동 인덱싱과 자동 워치는 설정 가능합니다. 내장 3D 그래프 시각화 UI는 localhost:9749에서 제공됩니다. - 팀 공유: 선택적 zstd 압축 SQLite 스냅샷(.codebase-memory/graph.db.zst)을 커밋하여 팀원들이 아티팩트에서 부트스트랩하고 전체 재인덱싱 대신 증분 인덱싱을 실행할 수 있습니다. 이 프로젝트는 LLM을 내장하지 않으며, MCP 클라이언트는 자연어 질문을 그래프 쿼리로 변환하는 지능 계층으로 작동합니다. README는 설계와 벤치마크를 설명하는 사전 출판물(arXiv:2603.27277)을 참조하고, 로컬 전용 처리 및 릴리스 아티팩트 검증과 같은 보안 관행을 문서화합니다.