Codebase Memory MCP
- 추천0
- GitHub 별49K
- 개발라이선스MIT
코드 · 문서 · 설정을 로컬 지식 그래프로 묶어 에이전트가 호출 추적 · 변경 영향 분석을 하게 해요. API 키 없이 로컬에서 돌아요
설치 방법은 설치 탭에 정리했어요.
설명
codebase-memory-mcp: MCP로 AI 에이전트에 주는 로컬 코드 인텔리전스
소스 코드부터 그 주변 시스템까지, 저장소를 이해하세요. codebase-memory-mcp는 코드 · 문서 · 설정 · 인프라를 하나의 영속적인 로컬 지식 그래프로 연결하는 MCP 서버예요. 낯선 기능을 찾고, 서비스 사이의 호출을 따라가고, 배포를 소스까지 거슬러 올라가 추적하고, 변경이 프로젝트의 어느 부분에 영향을 줄지 가늠할 때 써요.
Model Context Protocol(MCP)로 코딩 에이전트에 구조적인 맥락을 주거나, CLI에서 그래프를 직접 질의할 수 있어요. MCP 서버가 이 프로젝트의 핵심이에요. 선택 기능인 시각화 동반 도구 CBM Lens는 오픈 베타(v0.0.1) 이고, 소스 리더 · 아키텍처 지도 · Galaxy 그래프 · 커버리지 진단 · 아키텍처 결정 · 로컬 코드 채팅을 갖췄어요.
네이티브 C 백엔드가 17개 MCP 도구를 제공하고, 내장 문법으로 여러 언어와 파일 형식을 분석하며, 지원하는 언어에는 Hybrid LSP 타입 해석을 더해요. 설치 프로그램은 클라이언트 설정 · 스킬 · 에이전트 프로필 · 해당되는 훅까지 포함해 46개의 자동 또는 조건부 클라이언트 연동을 지원해요. 색인과 그래프 질의에는 호스팅 서비스도 API 키도 필요 없어요. 좁힌 그래프 질의는 반복되는 파일 읽기와 토큰 사용을 줄일 수 있어요. 측정 결과는 성능 절을 보세요.
로컬 처리: 소스 분석과 그래프 저장은 내 컴퓨터에서 이뤄져요. CBM Lens는 켠 뒤에 브라우저 AI용 모델을 선택적으로 내려받을 수 있고, 추론은 기기 안에서 해요. 설치 프로그램은 선택한 클라이언트의 에이전트 설정을 써요. 릴리스 검증은 SECURITY.md를 보세요.
CBM Lens로 그래프 보기 (오픈 베타 v0.0.1)
폴더는 겹겹의 플랫폼이 되고, 파일과 심볼은 선택할 수 있는 블록이 되며, 화살표는 색인된 관계를 보여 줘요. 아래 영상은 이 저장소 지도에서 src/foundation을 열고 arena.c를 선택해 소스를 여는 장면이에요. 높이는 소스 크기를, 핫스팟 중력은 정적 fan-in을 나타내요.

Galaxy. 코드 지식 그래프를 3D로 살펴봐요. 영상은 cbm_arena_alloc에서 나가는 관계를 한 층 더 펼친 뒤 계층 보기로 바꿔 cbm_alloc까지 두 단계 호출 경로를 보여 줘요. 모서리의 깜빡임은 관계의 방향을 뜻하고, 실제 실행을 나타내지는 않아요.

Explore. IDE 같은 작업 공간에서 파일을 둘러보고, Monaco로 문법 강조된 소스를 읽으며, 코드 그래프를 옆에 둘 수 있어요. 파일 영향(File impact)은 열린 파일에 의존하는 것을, 코드 상세(Code details)는 커서 위치 심볼의 호출하는 쪽과 호출받는 쪽을 보여 줘요. 코드를 선택해 로컬 채팅에 물어볼 수도 있어요.

시스템 구조와 동작. 시스템 구조는 심볼을 구성요소로 묶어 의존 관계를 살펴보게 해요. 동작(Behavior)은 선택한 작업에서 이어질 수 있는 호출과 그 근거가 되는 소스를 보여 줘요.


고해상도 GIF는 2026년 10월 20일의 CBM Lens 베타 화면이고, 정지 이미지는 10월 12~13일에 찍었어요. 모두 이 저장소의 공개 소스를 보여 줘요.
왜 codebase-memory-mcp인가
- 맥락과 함께 알맞은 코드 찾기: 심볼 · 텍스트 · 의미 검색을 호출하는 쪽, 의존성, 소스 조각, 파일 윤곽과 함께 써요. 목표를 좁힌 질의와 쪽 나눈 간결한 결과가 토큰 사용과 반복된 파일 읽기를 줄일 수 있어요.
- 문서를 구현과 연결하기: 문서 절 · PDF 텍스트 쪽 · 아키텍처 결정 · 지원하는 참조를 코드와 이어서, 심볼 옆에서 설명을 찾을 수 있어요.
- 소스 파일 너머의 시스템 따라가기: Docker · Kubernetes · Helm · Kustomize · Terraform/OpenTofu · Terragrunt · Ansible · 스크립트 · Make · CI 설정을 거치는 관계를 추적해요.
- 실행 전에 변경 이해하기: 영향받는 심볼을 살피고, 색인 스냅샷을 비교하고, 관련 테스트를 찾아요. 실험적인 Smart CI는 지원하는 C/C++ 테스트 하네스에서 정적 관계와 테스트별 커버리지를 합치고, 근거가 부족하면 더 넓게 실행해요.
- CBM Lens 베타로 눈으로 탐색하기: 소스를 읽고, 호출 경로를 따라가고, 아키텍처와 커버리지 공백을 살피고, 아키텍처 결정을 관리하고, 선택한 코드를 로컬 모델에 물어봐요.
- 코딩 에이전트 갖추기:
install이 지원하는 클라이언트의 설정 · 지속되는 안내 · 스킬 · Scout/Verify/Auditor 프로필 · 해당되는 맥락 훅을 설치해요. 지원 범위는 클라이언트마다 달라요. - 맥락을 로컬에 두고 재사용하기: 색인은 세션 사이에 유지되고, 조건이 맞는 활성 MCP 세션은 색인을 동기화해 두며, 선택 기능인 그래프 산출물로 팀이 기준선을 공유할 수 있어요.
- 내 컴퓨터에서 도는 네이티브 도구: 표준 릴리스에는 macOS · Linux · Windows용 CBM Lens가 들어 있어요. 네이티브 런타임은 Docker나 언어 런타임이 필요 없고 파서 문법이 포함돼 있어요.
빠른 시작
최신 릴리스 설치 (macOS / Linux):
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
표준 네이티브 릴리스에는 CBM Lens가 들어 있어요. 설치 뒤 codebase-memory-mcp daemon start --open --port=9749로 시작하세요. UI 없는 빌드는 Nix 패키지와 소스 빌드로도 받을 수 있어요.
Windows (PowerShell):
# 1. 설치 스크립트 내려받기
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
# 2. (선택, 권장) 스크립트 내용 확인
notepad install.ps1
# 3. 내려받은 파일 차단 해제 (브라우저/Invoke-WebRequest가 붙인 Mark-of-the-Web 제한 제거)
Unblock-File .\install.ps1
# 4. 실행
.\install.ps1
참고: 스크립트 실행 정책 오류가 나면 먼저
Set-ExecutionPolicy -Scope Process Bypass를 실행하거나PowerShell -ExecutionPolicy Bypass -File .\install.ps1로 실행하세요.
옵션: --skip-config(바이너리만 설치, 에이전트 설정 안 함), --dir=<경로>(설치 위치 지정).
백신 참고: Microsoft Defender가 릴리스 바이너리를
Trojan:Script/Wacatac.B!ml로 잘못 탐지할 수 있어요. 알려진 오탐이고, 보통 약 62개 엔진 중 61개가 안전하다고 판정해요. 증거와 직접 확인하는 방법은 백신 오탐 안내를 보세요.
코딩 에이전트를 다시 시작하고 **"Index this project"**라고 말하면 끝이에요.
수동 설치
- 최신 릴리스에서 운영체제에 맞는 압축 파일(
codebase-memory-mcp-<OS>-<아키텍처>.tar.gz또는 Windows용.zip)을 내려받아요. - 압축을 풀고 안에 든
install.sh또는install.ps1을 실행해요.
tar xzf codebase-memory-mcp-*.tar.gz
./install.sh
Expand-Archive codebase-memory-mcp-windows-amd64.zip -DestinationPath .
Unblock-File .\install.ps1
.\install.ps1
- 코딩 에이전트를 다시 시작해요.
install 명령은 macOS 격리 속성을 자동으로 지우고 바이너리에 임시 서명을 하므로 xattr나 codesign을 직접 실행할 필요가 없어요.
에이전트 설정: 스킬 · 프로필 · 훅
설치는 지원하는 코딩 에이전트가 일상 작업에서 그래프를 쓰도록 갖춰 줘요. 네이티브 install 명령이 클라이언트를 감지해, 각 클라이언트가 지원하는 형식으로 다음을 설치해요.
| 구성 요소 | 추가되는 것 |
|---|---|
| MCP 설정 | 클라이언트를 로컬 서버와 도구에 연결해요. |
| 안내와 스킬 | 그래프 우선 탐색, 색인 최신 여부, 커버리지 확인, 소스를 읽어야 할 때를 알려 줘요. |
| Scout · Verify · Auditor 프로필 | 사용자 정의 에이전트를 지원하는 곳에서 빠른 임시 조회, 작업 중심 검증, 범위를 정한 전체 검증을 제공해요. |
| 세션 · 압축 훅 | 지원하는 수명 주기 이벤트에서 그래프 맥락을 복원해요. |
| 검색 · 읽기 훅 | 지원하는 검색에 관련 그래프 맥락을 더하고, 파일을 읽은 뒤 기록된 커버리지 공백을 알려 줘요. |
훅은 맥락만 더하고 실패해도 막지 않아요. 요청한 도구 호출을 대체하거나 막지 않아요. 기능은 클라이언트와 플랫폼에 따라 달라요. Codex 사용자는 /hooks에서 설치된 훅을 검토하고 신뢰 설정을 해요.
훅은 기본으로 켜져 있어요. codebase-memory-mcp install --no-hooks는 CBM이 관리하는 훅을 지우되 MCP 등록과 다른 연동 파일은 남겨요. 이 선택은 이후 설치와 업데이트에도 유지돼요. codebase-memory-mcp install --hooks로 다시 켜고, codebase-memory-mcp config get install_hooks로 현재 설정을 확인해요.
세션 조율 데몬
CBM은 Claude Code · Codex · OpenCode 등 설정된 모든 클라이언트가 계정마다 하나의 조율 데몬을 함께 쓰게 해요. MCP 서버나 훅 클라이언트를 위한 켜기 설정은 따로 없어요. 데몬을 쓰는 첫 세션이 데몬을 시작하고, 각 세션이 자기 작업을 등록하며, 세션이 관리하는 데몬은 마지막 세션이 끝나면 멈춰요. daemon start로 시작한 데몬은 멈출 때까지 계속 돌아요. 데몬은 파일 감시 · 공유 색인 작업 · 선택 UI 같은 오래 도는 서비스를 맡아요.
데몬은 소유자만 읽을 수 있는 기록을 ${CBM_CACHE_DIR}/logs(기본 ~/.cache/codebase-memory-mcp/logs)에 남겨요.
| 파일 | 내용 |
|---|---|
cbm-daemon.log | 데몬 수명 주기, 감시 · 색인, UI, 자원, 오류 이벤트 |
daemon-conflicts.ndjson | 빌드 · 조율 ABI · 캐시 루트 충돌 기록 |
activation-events.ndjson | 설치 · 업데이트 · 제거 진행과 결과 |
활성 CBM 프로세스는 모두 같은 버전 · 실행 파일 빌드 · 조율 ABI · 캐시 루트로 돌아야 해요. 서로 다른 루트는 활성 프로세스가 있는 동안 거부돼요. 일반 명령이 충돌하면 작업을 시작하기 전에 실패하고 충돌이 기록돼요. 다만 네이티브 install과 uninstall은 예외로, 다운로드와 검증을 끝낸 뒤 데몬과 모든 임시 작업에 종료를 요청하고 기한 안에 모두 끝나기를 기다린 다음 활성 바이너리 · 설정 · PATH · 색인을 바꿔요. 성공하면 열려 있는 코딩 에이전트 세션을 다시 시작하라고 안내해요.
npm · PyPI · Go 패키지 설치는 네이티브 실행 파일을 확인해 캐시할 뿐 활성 설치를 바꾸지 않으므로 실행 중인 CBM 세션을 멈추지 않아요. 셸 · PowerShell 설치 스크립트는 확인된 후보의 install 명령을 실행하므로 계정 전체 교체 보장을 받아요.
일반 cli 모드는 명령 하나를 로컬에서 실행하지만 데몬과 분리돼 있지는 않아요. 공유 조율 데몬에 연결(없으면 시작)해 같은 허용 장벽과 프로젝트별 그래프 변경 잠금을 쓰고, 프로젝트 감시자를 등록하거나 브라우저를 열지 않아요.
CBM Lens 베타: 코드 시각화와 소스 탐색
CBM Lens는 MCP 서버의 선택적인 시각 동반 도구이고 현재 오픈 베타(v0.0.1)예요. 표준 네이티브 릴리스에 브라우저 인터페이스가 들어 있어 설치 후 바로 실행할 수 있어요. Bernhard Jackiewicz의 CodeAtlasWeb를 바탕으로 만들었어요. Lens는 루프백에서만 제공돼요. 브라우저 AI는 켠 뒤에만 선택 모델을 내려받고 추론은 기기에서 해요. 각 패널은 근거를 밝히고, 색인이 기록하지 못한 부분은 공백으로 표시해요.
codebase-memory-mcp daemon start --open --port=9749
브라우저가 http://127.0.0.1:9749로 열려요. 상주 데몬은 명령이 끝난 뒤에도 UI를 유지하고, daemon status로 상태를 보고 daemon stop으로 멈춰요.
첫 저장소 열기
- 프로젝트 메뉴에서 Add project index를 골라요(
Alt+P도 돼요). - 로컬 저장소 폴더를 고르고 색인 이름을 정해요. 파일은 그 자리에 그대로 있어요.
- 색인을 시작하고 보고되는 상태를 따라가요. 도중에 창을 닫아도 프로젝트 메뉴에서 다시 열 수 있어요.
- 색인된 프로젝트를 열어요. 개요는 Architecture, 파일 읽기는 Explore부터 시작하세요.
보기를 북마크하려면 ?project=<이름>&workspace=architecture를 써요. 다른 작업 공간 값은 explore · galaxy · adr · coverage · system이에요.
| 작업 공간 | 할 수 있는 일 |
|---|---|
| Explore | 색인된 파일 트리를 둘러보고 Monaco에서 소스를 읽어요. 파일 영향은 열린 파일에 의존하는 것을, 코드 상세는 커서 아래 심볼의 호출 · 참조 · 관련 테스트를 보여 줘요. |
| Galaxy | 그래프 노드를 검색 · 집중하고, 이웃을 층별로 불러오고, 계층 보기로 바꾸고, 경로를 따라가고, 소스를 열어요. 커버리지 그림자는 불러온 그래프 주변의 알려진 공백을 표시해요. |
| Architecture | 폴더 지도 · 진입점 · 경로 · 핫스팟 · 시스템 구조 · 동작 경로를 살펴요. 노드나 연결을 골라 근거를 확인해요. |
| ADR | 프로젝트의 아키텍처 결정 기록을 읽고 고쳐요. 직접 저장하며, 문서는 색인과 함께 저장되고 manage_adr와 공유돼요. |
| Coverage | 색인됨 · 부분 분석 · 건너뜀 · 제외된 경로와 최신 여부 정보를 확인해요. |
| System | 데몬 활동 · 색인 · 로그를 살펴요. 프로젝트 · 심각도 · 글로 로그를 걸러요. |
아키텍처 보기
- Overview: 3D 지도에서 소스 폴더와 파일을 오가요. 소스 크기 또는 균일한 높이, 언어 또는 종류 색, 관계 필터를 골라요. 진입점(Entry points)으로 바꾸면 시작 심볼에서 정적 호출 그래프를 따라가요.
- Routes: 서비스 지도와 엔드포인트 연결을 오가요. 배포 메타데이터와 색인된 경로 근거는 따로 보여요.
- Hotspots: fan-in · 복잡도 같은 측정 신호로 심볼을 살펴요. 중력 우물은 자주 참조되는 영역을 찾게 도와요. 코드 품질 점수는 아니에요.
- System structure: 구성요소 의존성을 살피고, 그룹을 펼치고, 순환을 따로 보고, 연결을 소스 근거까지 따라가요.
- Behavior: 시작점과 도달 가능한 목적지를 골라 정적 호출 경로와 소스 문장을 살펴요. 가능한 관계를 보여 줄 뿐 기록된 실행 순서가 아니에요. 런타임 관찰은 따로 수집한 트레이스를 넣어야 해요.
3D 보기는 끌어서 회전하고 스크롤로 확대해요. 큰 보기는 한계와 생략된 개수를 표시해요. 선이 없다고 해서 관계가 없다는 뜻은 아니니 결론 전에 Coverage와 소스를 확인하세요.
내 코드베이스와 로컬로 대화하기
오른쪽 위 단추로 Chat을 열어 지금 보는 코드에 대해 물어봐요. Explore에서는 열린 파일이나 선택한 글을, Galaxy에서는 선택한 노드와 불러온 이웃을 써요. Add context로 그래프 근거를 붙일 수도 있어요.
- 오른쪽 위 로봇 아이콘을 눌러 에이전트 설정을 열어요.
- 로컬 모델을 골라요. 기본 Qwen2.5 Coder 0.5B는 약 567 MB를 내려받고, Qwen3 0.6B · LFM2.5 1.2B · Qwen3.5 2B는 더 커요. 모두
shader-f16을 지원하는 WebGPU가 필요해요. - Download & load를 눌러요. 모델 파일은 Hugging Face에서 받고, 추론은 브라우저에서 돌아요. 호스팅 채팅 API도 API 키도 없어요.
- 질문하세요. 입력창에 질문과 함께 보낼 파일이나 선택 범위가 표시돼요.
"cbm_pipeline_run을 누가 부르나?" 같은 호출 관계 질문은 모델 없이 불러온 그래프에서 바로 답하고, 답에 그렇게 표시해요. 심볼을 고르면 색인된 사실과 코드 줄을 나열하고 모델이 문장 하나를 더해요. 그 문장이 소스에 없는 주장을 하면 빠져요. 모델이 쓴 글에는 그렇다고 표시돼요.

채팅 기록은 이 브라우저에 프로젝트별로 24시간 보관돼요. 이 채팅은 건네준 맥락을 설명할 뿐 파일을 고치거나 도구를 실행하지 못해요. 답은 소스와 대조하세요. 기본 소형 모델은 영어가 아닌 언어에서 표현이 느슨할 수 있어요.
검색
Cmd+K 또는 Ctrl+K로 Galaxy 검색을 열어요. 색인 전체에서 이름이나 경로로 심볼 · 파일 · 폴더를 찾고, 아직 불러오지 않은 노드도 찾아요.
자동 색인
MCP 세션 시작 때 자동 색인을 켜요.
codebase-memory-mcp config set auto_index true
auto_index는 기본으로 꺼져 있어요. 켜면 새 프로젝트는 처음 연결할 때 자동으로 색인돼요. 파일 수 한도는 config set auto_index_limit 50000으로 정해요. 이미 색인된 프로젝트는 auto_watch(기본 켜짐)로 감시할 수 있어요. 감시를 완전히 끄려면 config set watcher_enabled false를 쓰고 데몬을 codebase-memory-mcp daemon stop으로 멈춰요. 감시자는 기본으로 git 프로젝트만 따라가며, git이 아닌 폴더도 보려면 config set watch_non_git true를 써요. 짧게 쓰고 버리는 git worktree가 색인을 쌓지 않게 하려면 config set ignore_worktrees true를 써요. 자세한 설정은 설정 문서에 있어요.
최신 상태 유지
업데이트는 모든 플랫폼에서 설치 스크립트로 해요. 실행 중인 바이너리 안에서 하지 않아요. codebase-memory-mcp update는 옵션을 확인한 뒤 실행할 명령을 출력해요.
# macOS / Linux
bash "<install-dir>/install.sh"
# Windows
powershell -File "<install-dir>\install.ps1"
설치 스크립트는 설치할 때 바이너리 옆에 놓여요. 다시 실행하는 것이 곧 업데이트예요. 데몬을 멈추고, 실행 중인 바이너리를 치우고, 새 것을 설치하고, 정리해요. cbm은 스스로 네트워크 요청을 하지 않아요. 백그라운드에서 새 버전을 확인하지 않고 어디에도 정보를 보내지 않아요. 릴리스 소식은 설치 스크립트 · 패키지 관리자 · GitHub에서 알게 돼요.
npm이나 pip으로 설치했다면 패키지 관리자로 업데이트하세요(npm install -g codebase-memory-mcp@latest / pip install -U codebase-memory-mcp).
제거
codebase-memory-mcp uninstall
설정 항목 · 스킬 · 훅 · 안내 · 설치된 바이너리를 지워요. 기존 그래프 색인은 목록으로 보여 주고 기본으로 남겨요. -y/--yes, -n/--no, 비대화형 입력은 --delete-indexes를 명시하지 않으면 색인을 남겨요.
codebase-memory-mcp uninstall -y --delete-indexes # 모든 프로젝트 색인도 삭제
codebase-memory-mcp uninstall --dry-run --delete-indexes # 미리보기, 아무것도 바꾸지 않음
바이너리 옆 설치 스크립트는 지우지 않고 경로와 rm 명령만 알려 줘요. 사용자가 직접 둔 복사본이나 패키지 관리자 소유일 수 있어서예요.
기능
그래프 · 분석
- 아키텍처 개요:
get_architecture는 기본으로 간결한 요약을 돌려줘요. 경로 · 핫스팟 · 의존성 · 군집 · 순환은aspects로 요청해요.system_structure는 CBM Lens가 쓰는 투영이라 단독으로 요청해야 해요. - 아키텍처 결정 기록:
manage_adr이 프로젝트의 결정 기록을 세션을 넘어 보관해요. 색인도 문서에서 지원하는 ADR 메타데이터와 대체 관계를 뽑아요. - Louvain 커뮤니티 탐지: 호출 관계를 묶어 기능 모듈을 찾아요.
- 변경 영향:
detect_changes는 커밋하지 않은 변경을 영향받는 심볼에 위험 등급과 함께 이어 주고,scope: "tests"로 테스트 영향도 보고해요.compare_graphs는 색인 스냅샷을 비교해요. - 런타임 관찰:
ingest_traces는 따로 수집한 트레이스에서 관찰된 호출 관계를 정적 분석 옆에 더해요. - 호출 그래프: 파일과 패키지를 넘는 함수 호출을 임포트와 타입 추론으로 해석해요.
- 죽은 코드 후보: 진입점을 뺀, 색인된 호출자가 없는 함수를 찾아요. 지우기 전에 동적 디스패치와 커버리지 공백, 프레임워크 관례를 확인하세요.
- Cypher 비슷한 질의:
MATCH (f:Function)-[:CALLS]->(g) WHERE f.name = 'main' RETURN g.name
검색
- 의미 검색(
search_graph의semantic_query매개변수): 바이너리에 내장된 Nomicnomic-embed-code임베딩으로 그래프 전체를 벡터 검색해요. API 키 · Ollama · Docker가 필요 없어요. - BM25 전문 검색: camelCase · snake_case를 나누는
cbm_camel_split토크나이저를 쓰는 SQLite FTS5예요. - 구조 검색(
search_graph): 이름 정규식 · 레이블 필터 · 최소/최대 차수 · 파일 범위. - 코드 검색(
search_code): 색인된 파일만 대상으로 하는 그래프 보강 grep이에요.
코드와 이어진 문서
심볼 뒤의 설명을 찾고, 지원하는 참조를 따라 구현으로 돌아가요. 문서도 소스 파일과 함께 그래프에 참여해요.
- Markdown · reStructuredText · AsciiDoc은 탐색 가능한 문서 절이 되고, 텍스트 레이어가 있는 PDF는 검색 가능한 텍스트 쪽이 돼요. PDF는 OCR을 하지 않아요.
- 문서-코드 참조와 언어의 문서 주석 참조는 대상을 해석할 수 있을 때
MENTIONS관계를 만들어요. - 아키텍처 결정 기록은 상태 · 결정자 · 대체 관계 같은 메타데이터를 보태요.
- 지원하는 다이어그램과 OpenAPI 설명은 구조화된 개체를 보태요.
못 찾았을 때는 "그런 문서가 없다"로 단정하기 전에 check_index_coverage를 확인하세요.
인프라와 배포
"이 서비스는 무엇이 배포하지?", "어떤 이미지가 돌리지?", **"이 설정은 코드의 어디에 닿지?"**를 물어보세요. CBM은 지원하는 인프라 형식을 그것이 빌드 · 설정 · 실행하는 소스에 이어 줘요.
- 컨테이너와 클러스터: Dockerfile · Compose 서비스 · Kubernetes 리소스 · Helm 차트와 릴리스 · Kustomize 오버레이와 패치.
- 프로비저닝과 설정: Terraform/OpenTofu 리소스와 모듈 · tfvars 재정의 · Terragrunt 의존성 · Ansible 작업과 핸들러 · 지원하는 설정 키와 환경 변수 접근.
- 빌드와 배포: 이미지를 빌드하거나 저장소 스크립트를 부르거나 리소스를 배포하는 셸 명령 · Make 타깃 · 지원하는 CI 단계.
해석할 수 있는 입력이라면 서비스 → 워크로드 → 이미지 → Dockerfile → 프로그램 순서로 추적할 수 있어요. 토폴로지 · 배포 · 실행 경로는 trace_path 모드를 쓰세요. 지원하는 소스 형식에서 얻은 정적 관계라서 동적 값이나 해석되지 않은 템플릿은 공백으로 남을 수 있어요.
서비스 간 연결
- HTTP 경로 ↔ 호출 지점 매칭을 신뢰도 점수와 함께 제공해요.
- gRPC · GraphQL · tRPC 서비스를 감지하고 protobuf Route를 뽑아요.
- Socket.IO · EventEmitter 등 pub-sub 패턴의 채널 감지(
EMITS/LISTENS_ON)를 8개 언어에서 상수 해석과 함께 지원해요.
저장소 간 인텔리전스
CROSS_*관계가 같은 저장소에 색인된 여러 프로젝트의 노드를 이어요.- 색인된 전체에 걸친 서비스 · 경로 · 의존성의 저장소 간 아키텍처 요약을 제공해요.
index_status의cross_repo객체로 "연결한 적 없음"과 "연결했지만 맞는 것이 없음"을 구분해요.
Smart CI와 테스트 영향
그래프로 변경이 어떤 테스트에 닿는지 설명하고, 그 근거로 지원하는 CI 실행을 좁혀요. Smart CI는 실험 기능이고 두 층이에요.
| 층 | 하는 일 | 직접 마련할 것 |
|---|---|---|
| CI 작업 선택 | 바뀐 파일 목록에서 작업을 골라요. | 저장소별 경로 · 작업 규칙. 이 저장소의 선택기가 예시예요. |
| 테스트 선택 | 정적 도달 가능성 · 바뀐 테스트 · 인정된 테스트별 커버리지를 합쳐 스위트나 테스트를 골라요. | 지원하는 C/C++ 테스트 하네스 · 설정 · 커버리지 맵 · 이름 있는 선택을 받는 실행기. |
codebase-memory-mcp test-impact select가 이유와 함께 선택을 만들고, test-impact publish가 기준선으로 쓰는 그래프-커버리지 묶음을 만들어요. 에이전트가 조사할 때는 detect_changes에 scope: "tests"를 줘서 MCP로 테스트 영향을 봐요. 좁히기는 현재 이 저장소의 테스트 관례(또는 선언한 동등물)를 쓰는 C/C++ 계열 코드만 지원해요. 근거가 없거나 오래됐거나 불완전하면 선택을 넓히거나 run_all을 돌려줘요. 먼저 보고만 하는 그림자 모드로 시작해 하네스를 검증한 뒤 게이트를 켜세요. 자세한 내용은 Smart CI 가이드를 보세요.
관계 종류 (일부)
CALLS: 호출 지점에서 호출 가능한 대상이 불려요.CALL_REFERENCE: 지원하는 참조 지점(직접 값 인자 등)에서 하나의 정확한 대상으로 해석돼요.USAGE: 식별자가 쓰였지만 유일한 호출 대상은 확정되지 않았어요.IMPORTS,DEFINES,IMPLEMENTS,INHERITSHTTP_CALLS,ASYNC_CALLS(서비스 사이),SPAWNS(다른 프로그램 시작),INFRA_MAPS(Kubernetes Service와 워크로드),CONNECTS_TO(워크로드와 서비스 연결)
제공하는 도구 (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 |
더 알아보기
원문 README에는 위에서 다룬 내용 말고도 여러 에이전트 지원 표, 언어 지원, Hybrid LSP 타입 해석, 성능 측정, 보안, 테스트 절이 이어져요. 164개 언어를 tree-sitter 문법으로 분석하고, 릴리스는 SHA-256 체크섬과 VirusTotal 검사를 거쳐요.
라이선스
MIT 라이선스예요(저장소 LICENSE 파일 기준).