DeusData/codebase-memory-mcp

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

codebase-memory-mcp – AI 코딩 에이전트를 위한 빠르고 로컬 기반의 코드 지능 엔진

무엇인가요 – Tree-sitter 파서를 사용하여 158개 언어를 지원하는 코드베이스의 지속 가능한 지식 그래프(함수, 클래스, 호출 체인, HTTP 라우트, 인프라 파일 등)를 구축하는 네이티브이고 런타임이 없는 실행 파일입니다. 그래프는 밀리초 단위로 쿼리 가능하며, AI 기반 코딩 어시스턴트(Claude Code, Codex, OpenCode 등)가 원격 서비스에 소스 파일을 전송하지 않고도 구조적 질문에 즉시 답변할 수 있도록 설계되었습니다.

왜 중요한가요 – 기존의 LLM 기반 코드 도구는 파일을 하나씩 스캔하기 때문에 느리고 토큰 소비가 큽니다. 이 도구는 리포지토리를 한 번만 인덱싱하고 그래프를 노출함으로써 토큰 예산을 약 120배 줄이고, 도구 호출 오버헤드를 2배 이상 감소시킵니다. 또한 "이 함수는 어디서 사용되나요?" 또는 "이 변경의 영향은 무엇인가요?"와 같은 복잡한 질문도 1밀리초 미만으로 답변할 수 있습니다.

핵심 기능

기능	기능 설명
초고속 인덱싱	전체 Linux 커널(28M LOC, 75k 파일)을 약 3분 내에 인덱싱; 일반 리포지토리는 초 단위로 처리 가능.
하이브리드 LSP 타입 해석	Python, TS/JS, PHP, C#, Go, C/C++, Java, Kotlin, Rust, Perl 등 12개 주요 언어에 대해 가벼운 C 구현을 사용해 인기 있는 언어 서버를 모방하는 심층 의미 분석을 수행.
그래프 및 분석 API	함수, 클래스, 임포트, 호출 엣지, HTTP 라우트, gRPC/GraphQL 서비스, 이벤트 채널 엣지, 미사용 코드 탐지, 커뮤니티 탐지(Louvain), git 차이용 영향 맵핑, ADR 관리 등.
쿼리 언어	• Cypher 유사: 그래프에서 패턴 매칭 • 의미적 검색: 별도의 API 키 없이 내장된 Nomic 코드 임베딩 사용 • BM25 전체 텍스트 via SQLite FTS5, camelCase/snake_case 인식 토크나이저 사용 • 구조적/정규식 검색: 노드 레이블 기반
내장 3D UI	로컬 웹 UI(`localhost:9749`)를 시작하여 하나 또는 여러 리포지토리에 걸친 그래프를 시각화.
크로스 리포지토리 지능	여러 인덱싱된 리포지토리의 노드가 연결 가능하여 팀 전체 아키텍처 뷰를 가능하게 함.
제로 런타임, 로컬 전용	Docker, 언어 런타임, 외부 API 키 없음. 모든 처리는 개발자의 머신에서 수행.
에이전트 통합	Claude Code, Codex, OpenCode 등 43개 지원 에이전트를 자동 감지하고, 에이전트 설정 파일에 필요한 MCP 항목을 자동으로 작성.
패키지 매니저 배포	npm, PyPI, Homebrew, Scoop, Winget, AUR, `go install`를 통해 이용 가능.

일반적인 워크플로우

설치 – macOS/Linux에서는 curl … | bash, Windows에서는 PowerShell 스크립트로 검증된 바이너리와 작은 설치 헬퍼를 다운로드.
인덱싱 – 설치 후 도구는 자동으로 코딩 에이전트를 감지. 에이전트에게 "이 프로젝트를 인덱싱해줘"라고 명령. 데몬이 그래프를 생성하고 ~/.cache/codebase-memory-mcp/에 저장.
쿼리 – 에이전트 또는 CLI에서 search_graph, detect_changes, 사용자 정의 Cypher 쿼리 등을 실행. 이제 에이전트는 구조적 질문에 즉시 응답 가능.
시각화 – codebase-memory-mcp --ui=true --port=9749를 실행하여 브라우저에서 그래프 탐색.
업데이트 / 제거 – 동일한 설치 스크립트로 업그레이드 가능. codebase-memory-mcp uninstall로 설정 항목과 선택적 인덱스 정리.

누구에게 적합한가요

LLM 기반 코딩 어시스턴트에 의존하며, 자신의 코드에 대해 결정론적이고 낮은 지연 시간의 답변을 원하는 개발자.
코드베이스의 공유되고 버전 관리 가능한 표현이 필요한 팀 (.codebase-memory/graph.db.zst 아티팩트를 커밋함으로써 재인덱싱을 피할 수 있음).
코드 그래프 기반 프롬프팅이나 LLM을 위한 도구 호출 전략을 탐구하는 연구자.

제한 사항 및 고려 사항

로컬 전용 – 클라우드 서비스 없음. 그래프가 필요한 각 기계에서 바이너리를 실행해야 함.
초기 인덱싱 비용 – 첫 번째 전체 인덱싱은 메모리 집약적일 수 있음(인메모리 SQLite, LZ4 압축) 하지만 완료 후 메모리 해제.
오류 경고 방지 프로그램 경고 – 일부 스캐너(Microsoft Defender 등)가 바이너리를 경고할 수 있음. 프로젝트는 해시와 VirusTotal 스캔을 제공하여 무결성 검증 가능.
지원 언어 – 158개 문법이 포함되어 있지만, 심층 의미적 타입 해석(하이브리드 LSP)은 상기 12개 언어에 한정.
에이전트 호환성 – 43개 언급된 에이전트는 즉시 작동; 다른 도구는 수동으로 MCP 항목 구성 필요.

빠른 시작 스크립트

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
# Windows (PowerShell)
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
notepad install.ps1   # 선택적 검토
Unblock-File .\install.ps1
.\install.ps1

설치 후 코딩 어시스턴트를 재시작하고 "이 프로젝트를 인덱싱해줘" 명령을 실행하세요.

더 알아보기

연구 논문 – Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP (arXiv:2603.27277).
문서 – 리포지토리의 README, SECURITY.md, 그리고 리포지토리 내 UI 스크린샷이 그래프 스키마와 데몬 조율에 대한 깊이 있는 정보 제공.
릴리스 – 각 릴리스에는 동일한 3개의 바이너리(비스트립, 디버그 스트립, 스트립)가 포함되며, VirusTotal 스캔 완료 및 SHA-256 해시로 서명됨.

결론 – codebase-memory-mcp는 자체 포함형이고 고성능인 코드 그래프 엔진을 제공하여 AI 코딩 에이전트가 코드베이스를 로컬에서 처리할 수 있게 하며, 토큰 사용량과 지연 시간을 극적으로 줄이고 모든 것을 당신의 통제 아래에 두는 데 기여합니다.