codebase-memory-mcp의 개요
DeusData의 codebase-memory-mcp는 내장된 163개의 tree-sitter 문법으로 저장소를 분석해 함수, 클래스, 파일, import, 호출, 라우트, 데이터 흐름으로 이루어진 SQLite 지식 그래프를 만들고, 세션 사이에도 ~/.cache/codebase-memory-mcp에 보관합니다. v0.12.0부터는 Markdown과 PDF 문서, 아키텍처 결정 기록, Dockerfile, Kubernetes 매니페스트, Helm 차트, Terraform, CI 작업도 그래프에 들어갑니다. 덕분에 에이전트는 Service에서 워크로드와 이미지를 거쳐 컨테이너가 실행하는 프로그램까지 따라갈 수 있습니다. Hybrid LSP 단계가 Python, TypeScript, Go, Java, Rust 등 11개 언어 계열에 대해 타입 해석으로 호출 간선을 다듬습니다.
서버는 17개의 MCP 도구를 제공합니다. search_graph(바이너리에 컴파일된 임베딩 모델을 쓰는 구조·BM25·의미 검색), trace_path, git diff의 영향 범위를 보여 주는 detect_changes, 읽기 전용이며 Cypher와 비슷한 query_graph 등이 있습니다. 설치 프로그램은 Claude Code, Codex, Gemini CLI, Cursor, OpenCode를 포함한 46개 클라이언트 연동을 설정합니다. 선택 사항인 브라우저 뷰어 CBM Lens는 공개 베타입니다.
저장소는 2026년 2월에 만들어졌고 MIT 라이선스이며 C로 작성되었고, 스타는 약 48,500개, 포크는 약 4,000개입니다. 최신 릴리스는 2026년 10월 16일의 v0.12.1입니다. 11월 10일까지 한 주 동안 npm 패키지는 약 12,100회, PyPI 패키지는 약 2,100회 다운로드되었습니다.
codebase-memory-mcp 설치 방법
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bashcodebase-memory-mcp, 쓸 만한 가치가 있습니까?
codebase-memory-mcp는 이 분야의 어떤 코드 그래프보다 시스템의 더 넓은 부분을 다룹니다. CodeGraph와 GitNexus가 소스 파일에서 멈추는 반면, 이 도구는 코드를 그것을 빌드하고 배포하는 Dockerfile, Kubernetes 객체, Helm 차트, Terraform 모듈, CI 단계와 연결합니다. 그래서 trace_path는 "이 함수를 누가 호출하나?"뿐 아니라 "이 서비스를 무엇이 배포하나?"에도 답할 수 있습니다. 이 폭을 MIT로 제공한다는 점은 GitNexus의 비상업 라이선스가 따라올 수 없는 부분입니다.
공개된 수치는 크지만 출처는 개발자 자신입니다. 메인테이너들이 2026년 3월에 낸 arXiv 프리프린트는 31개 저장소에서 파일을 하나씩 살펴보는 방식보다 토큰 사용량이 10배 적고 도구 호출이 2.1배 적었다고 보고합니다. README는 Linux 커널 전체(75K개 파일, 28M줄) 인덱싱이 Apple M3 Pro에서 3분, Cypher 쿼리가 1 ms 미만이라고 밝힙니다. 독립적인 재현 결과는 찾지 못했습니다.
개인정보 기본 설정은 경쟁 도구보다 낫습니다. README에 따르면 바이너리는 스스로 네트워크 요청을 보내지 않고, 업데이트를 확인하지 않으며, 텔레메트리를 수집하지 않습니다. 반면 CodeGraph와 CocoIndex Code는 끄지 않는 한 사용 데이터를 보냅니다. 의미 검색은 바이너리에 컴파일된 임베딩 모델로 동작해 Ollama나 API 키가 필요 없습니다. 릴리스에는 SLSA Level 3 출처 증명, cosign 서명, 체크섬, VirusTotal 검사 결과가 함께 제공됩니다. 그래도 Microsoft Defender가 일부 빌드를 탐지하며, 프로젝트는 이를 오탐으로 문서화해 두었습니다.
설치는 도구 목록이 주는 인상보다 무겁습니다. 빠른 시작은 curl을 bash로 넘기는 스크립트이며, v0.12.0 바이너리는 331~335 MB로 너무 커서 v0.12.1 전까지 npm, PyPI, Go 설치 프로그램이 작동하지 않았습니다. 설치 프로그램은 기본으로 훅을 추가합니다. Claude Code에서는 Grep, Glob, Bash에 걸리는 비차단 PreToolUse 훅이 그래프 컨텍스트를 끼워 넣으며, install --no-hooks로 제거할 수 있습니다. CBM_ALLOWED_ROOT를 설정하지 않으면 index_repository는 어떤 경로든 받아들입니다.
진짜 문제는 성숙도입니다. 열린 이슈가 약 487개이며, 6월부터 열려 있는 메모리 누수 보고와 3월부터의 높은 CPU 사용 보고도 있습니다. v0.12.0 한 번에만 231개의 풀 리퀘스트가 병합되었습니다. 팀이 공유하는 그래프 산출물은 선택 사항이지만, README는 갱신할 때마다 커밋한 어느 팀의 기록이 350개 커밋 동안 약 6 GB로 불어났다고 경고합니다.
제 역할을 하는 곳
서비스를 Kubernetes에서 운영하는 회사의 플랫폼 엔지니어
공유 라이브러리 변경이 어떤 배포와 이미지에 닿는지 파악하기
index_repository로 모노레포를 인덱싱한 뒤, 에이전트에게 브랜치에서 detect_changes를, deploy와 run 모드로 trace_path를 실행하게 합니다. Service, 워크로드, 이미지, Dockerfile, 프로그램 순으로 따라가며, 해석할 수 없는 템플릿 Helm 값은 빠지므로 빈틈은 check_index_coverage로 확인합니다.
CI 테스트 스위트가 느린 C/C++ 팀
풀 리퀘스트가 영향을 줄 수 있는 테스트만 실행하기
실험 단계인 Smart CI 계층은 정적 도달 가능성과 테스트별 커버리지를 결합하고, 근거가 부족하면 run_all로 돌아갑니다. 지원되는 하네스를 쓰는 C/C++ 코드만 범위를 좁힐 수 있으니, README의 권고대로 보고만 하는 섀도 모드로 시작합니다.
규제 산업 기업에서 개발 조직 전체로 에이전트를 확대하는 엔지니어링 매니저
공급업체 계약 없이, 데이터를 노트북 밖으로 내보내지 않고 모두에게 코드 그래프 컨텍스트 제공하기
MIT 라이선스에 텔레메트리도 호스팅 서비스도 없으니 협상할 것이 없습니다. 관리형 설정에 CBM_ALLOWED_ROOT를 지정해 인덱싱 범위를 제한하고, 기본 훅을 유지할지 --no-hooks로 설치할지 미리 정합니다.
도입 전 확인할 점
- 설정
- curl로 install.sh 스크립트를 받거나(Windows는 install.ps1) npm, PyPI, Homebrew, AUR, Nix, go install을 사용합니다. Claude Code 플러그인도 있습니다. 설치 프로그램은 클라이언트를 감지해 MCP 설정, skill, 에이전트 프로필 3개, 훅을 기록합니다. 에이전트를 재시작하고 "Index this project"라고 말하면 됩니다. auto_index는 기본으로 꺼져 있습니다.
- 연동
- 도구 17개: index_repository, list_projects, delete_project, index_status, check_index_coverage, search_graph, trace_path, detect_changes, query_graph, get_graph_schema, compare_graphs, get_code_snippet, get_file_outline, get_architecture, search_code, manage_adr, ingest_traces. 소스 코드를 수정하는 도구는 없으며, 쓰기는 인덱스와 그 ADR 문서, 그리고 persistence: true일 때만 저장소 .codebase-memory 폴더의 그래프 스냅샷에 이뤄집니다.
- 데이터와 개인정보
- 인덱스와 그래프는 ~/.cache/codebase-memory-mcp에 로컬로 저장됩니다. README에 따르면 바이너리는 텔레메트리를 보내지 않고 요청받지 않은 네트워크 요청도 하지 않습니다. CBM Lens는 실행했을 때만 127.0.0.1에서 수신하며, 선택형 브라우저 모델은 Hugging Face에서 내려받습니다. 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 무료이며, 비용은 로컬 CPU, RAM, 디스크뿐입니다. 인덱싱 메모리는 index_max_rss_mb나 CBM_MEM_BUDGET_MB로 제한할 수 있습니다. 절감 효과는 질문마다 읽는 파일이 줄어 모델 요금에서 나타납니다.
- 제한
- stdio만 지원하며, 네이티브 HTTP 전송은 열려 있는 기능 요청입니다. 긴 동기식 인덱싱 호출은 클라이언트 제한 시간을 넘길 수 있어 큰 저장소에는 비동기 모드가 필요합니다. Hybrid LSP는 11개 언어 계열을 다루며, 나머지는 텍스트 기반 해석에 의존합니다. 실행 중인 모든 프로세스는 정확히 같은 빌드여야 합니다.
좋은 점
- 그래프가 코드, 문서, Docker, Kubernetes, Helm, Terraform, CI를 아우름
- MIT 라이선스이며 바이너리의 텔레메트리나 네트워크 호출이 없음
- 17개 도구로 읽기 전용 Cypher 쿼리와 diff 영향 범위 제공
- SLSA Level 3 출처 증명이 붙은 서명된 릴리스
아쉬운 점
- 열린 이슈 약 487개, 메모리와 CPU 관련 보고 포함
- 설치 프로그램이 기본으로 에이전트 도구 호출에 훅을 추가함
- 바이너리가 330 MB 이상이며 빠른 시작은 curl을 bash로 실행
- 내세우는 토큰 절감은 메인테이너 자신의 연구 결과
추천 대상
서비스와 배포 설정을 넘나들며 변경을 추적해야 하는 에이전트를 쓰면서, 회사가 받아들일 수 있는 라이선스를 원하고 아무것도 컴퓨터 밖으로 내보내고 싶지 않은 팀.
codebase-memory-mcp 대안
codebase-memory-mcp: 자주 묻는 질문
- codebase-memory-mcp, 쓸 만한 가치가 있습니까?
- MIT로 돌릴 수 있는 가장 폭넓은 코드 그래프로, 함수부터 Helm 차트까지 다루고 텔레메트리도 없지만, 설치 시 추가되는 훅과 500개 가까운 열린 이슈를 감수할 수 있어야 합니다. 평점은 5점 만점에 4.2점입니다.
- codebase-memory-mcp의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 호스팅 요금제, 계정, API 키가 없 습니다.
- codebase-memory-mcp의 단점은 무엇입니까?
- 열린 이슈 약 487개, 메모리와 CPU 관련 보고 포함; 설치 프로그램이 기본으로 에이전트 도구 호출에 훅을 추가함; 바이너리가 330 MB 이상이며 빠른 시작은 curl을 bash로 실행; 내세우는 토큰 절감은 메인테이너 자신의 연구 결과.
- codebase-memory-mcp에 적합한 사람은 누구입니까?
- 서비스와 배포 설정을 넘나들며 변경을 추적해야 하는 에이전트를 쓰면서, 회사가 받아들일 수 있는 라이선스를 원하고 아무것도 컴퓨터 밖으로 내보내고 싶지 않은 팀.
- 팀이나 프로덕션 환경에서 codebase-memory-mcp의 비용은 얼마입니까?
- 무료이며, 비용은 로컬 CPU, RAM, 디스크뿐입니다. 인덱싱 메모리는 index_max_rss_mb나 CBM_MEM_BUDGET_MB로 제한할 수 있습니다. 절감 효과는 질문마다 읽는 파일이 줄어 모델 요금에서 나타납니다.
- codebase-memory-mcp에 회사 데이터를 맡겨도 안전합니까?
- 인덱스와 그래프는 ~/.cache/codebase-memory-mcp에 로컬로 저장됩니다. README에 따르면 바이너리는 텔레메트리를 보내지 않고 요청받지 않은 네트워크 요청도 하지 않습니다. CBM Lens는 실행했을 때만 127.0.0.1에서 수신하며, 선택형 브라우저 모델은 Hugging Face에서 내려받습니다. 공개된 보안 권고는 없습니다.
- codebase-memory-mcp의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰 한 것 중 가장 가까운 대안은 CodeGraph, GitNexus, code-review-graph, Serena 및 CocoIndex Code입니다.
답변 확인일: 2026년 11월 11일.
codebase-memory-mcp 개발사입니까? 이 평점을 사이트에 표시하십시오
