codebase-memory-mcp
코드베이스를 지식 그래프로 색인하는 MCP 서버
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash저장소를 트리시터 AST 로 파싱해 함수와 클래스, 호출 사슬, HTTP 라우트, 서비스 간 연결을 담은 지식 그래프로 만들어 두고 에이전트가 질의하게 합니다. 162개 언어의 문법을 바이너리에 넣어 두어 별도 설치가 없고, 파이썬과 타입스크립트, Go, 러스트 등 열두 개 언어는 LSP 로 타입까지 해석합니다. 리눅스 커널 2800만 줄 7만5천 파일을 3분에 색인하고 구조 질의는 1밀리초 아래로 답합니다. 도커나 언어 런타임, API 키가 필요 없는 네이티브 실행 파일이고 처리는 전부 로컬에서 끝납니다. 15개 MCP 도구와 3D 그래프 화면을 함께 제공합니다.
판단
이럴 때 씁니다
- 에이전트가 파일을 하나씩 열어 보느라 토큰을 태울 때
- 호출 사슬이나 영향 범위를 구조로 물어야 할 때
- 저장소가 커서 grep 반복으로는 구조가 안 잡힐 때
이럴 땐 쓰지 마세요
- 파일 몇 개짜리 프로젝트에는 색인 자체가 과합니다
- 의미 검색이 목적이면 임베딩 기반 도구가 맞습니다
- 에이전트 설정 파일을 자동으로 고치는 동작을 허용할 수 없는 환경에는 맞지 않습니다
차별점
- 162개 언어 문법을 바이너리에 넣어 두어 추가 설치가 없습니다.
- 구조 질의 다섯 개가 파일 탐색 대비 토큰을 두 자릿수 배수로 줄입니다.
- 설계와 벤치마크를 논문으로 공개했고 31개 실제 저장소에서 평가했습니다.
워크플로
- 01설치 스크립트로 네이티브 실행 파일을 받습니다.
- 02install 을 돌리면 감지된 에이전트 클라이언트 설정에 MCP 서버가 등록됩니다.
- 03에이전트를 재시작합니다.
- 04저장소를 색인한 뒤 구조 질의로 호출 사슬과 영향 범위를 물어봅니다.
- 05필요하면 로컬 3D 그래프 화면에서 직접 확인합니다.
주요 명령
| 명령 | 설명 |
|---|---|
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash | 실행 파일을 받습니다. |
codebase-memory-mcp install | 감지된 에이전트 클라이언트 설정에 등록합니다. |
http://localhost:9749 | 3D 지식 그래프 화면을 엽니다. |
함정
설치 전에 확인하세요
- 이 도구는 코드를 읽고 에이전트 설정 파일을 고칩니다. 설계상 그런 동작이므로 감사한 뒤 쓰고 싶다면 소스를 먼저 확인해야 합니다.
- v0.10.7 은 릴리스 파이프라인 오류로 v 접두사 없이 태그가 붙어 사라졌습니다. 패키지 설치기가 v 접두사 태그를 찾으므로 npm 과 PyPI 의 0.10.7 패키지는 쓰지 말고 v0.10.8 로 올려야 합니다.
- 색인 중에는 램을 크게 씁니다. 색인이 끝나면 반환하지만 대형 저장소를 다룰 때는 여유를 봐야 합니다.
비교
코드 검색 MCP 는 보통 임베딩으로 비슷한 조각을 찾아 줍니다. 이쪽은 AST 로 그래프를 만들어 두고 호출 사슬과 라우트, 서비스 간 연결을 구조로 답합니다. 무엇과 비슷한지가 아니라 무엇이 무엇을 부르는지를 물을 때 차이가 납니다.
최근 변경
v0.10.8 이 v0.10.7 을 대체합니다. v0.10.7 은 태그가 v 접두사 없이 붙는 릴리스 파이프라인 오류로 유실됐고 릴리스 불변성 때문에 이름을 되찾을 수 없어 다시 냈습니다.