codebase-memory-mcp

코드베이스-메모리-MCP: MCP를 통한 AI 에이전트용 로컬 코드 인텔리전스

소스 코드부터 주변 시스템까지, 저장소를 이해하세요. codebase-memory-mcp는 코드, 문서, 구성, 인프라를 영구적인 로컬 지식 그래프로 연결하는 MCP 서버입니다. 낯선 기능을 찾거나, 서비스 간 호출을 추적하거나, 배포를 소스까지 거슬러 올라가거나, 변경이 프로젝트의 어느 부분에 영향을 줄 수 있는지 평가할 때 사용하세요.

Model Context Protocol(MCP)을 통해 코딩 에이전트에 구조적 컨텍스트를 제공하거나, CLI에서 그래프를 직접 쿼리할 수 있습니다. MCP 서버가 프로젝트의 핵심입니다. 선택적 시각적 동반 도구인 CBM Lens는 오픈 베타(v0.0.1) 상태이며, 소스 리더, 아키텍처 맵, Galaxy 그래프, 커버리지 진단, 아키텍처 결정, 로컬 코드 채팅을 제공합니다.

네이티브 C 백엔드는 17개의 MCP 도구를 노출하고, 벤더링된 문법으로 언어와 파일 형식을 파싱하며, 지원 언어에 대해 Hybrid LSP 타입 해석을 추가합니다. 설치 프로그램은 클라이언트 구성, 스킬, 에이전트 프로필, 해당 훅을 포함한 45개의 자동 또는 조건부 클라이언트 통합을 지원합니다. 인덱싱과 그래프 쿼리에는 호스팅 서비스나 API 키가 필요하지 않습니다. 집중된 그래프 쿼리는 반복적인 파일 읽기와 토큰 사용을 줄일 수 있습니다. 측정 결과를 참조하세요.

빠른 시작 · 기능 · 문서 · 인프라 · 스마트 CI · CBM Lens 살펴보기 · 에이전트 설정 · MCP 도구

로컬 처리: 소스 분석과 그래프 저장은 사용자의 머신에서 실행됩니다. CBM Lens는 사용자가 활성화한 후 브라우저 AI용 모델을 선택적으로 다운로드할 수 있으며, 추론은 기기에 남습니다. 설치 프로그램은 선택한 클라이언트에 대한 에이전트 구성을 작성합니다. 릴리스 검증은 Security를, 이슈 보고는 SECURITY.md를 참조하세요.

CBM Lens(오픈 베타 v0.0.1)로 그래프를 확인하세요. 폴더는 중첩된 플랫폼이 되고, 파일과 심볼은 선택 가능한 블록이 되며, 화살표는 인덱싱된 관계를 보여줍니다. 녹화 영상은 이 저장소의 맵에서 src/foundation을 열고, arena.c를 선택하여 소스를 엽니다. Height는 소스 크기를 표시할 수 있고, hotspot gravity는 정적 fan-in을 반영합니다. 정지 이미지.

Galaxy. 코드 지식 그래프를 3D로 탐색하세요. 녹화 영상은 cbm_arena_alloc의 나가는 관계를 한 계층 더 따라가고, 계층 구조로 전환하여 cbm_alloc까지의 2-hop 호출 경로를 보여줍니다. 엣지 펄스는 관계 방향을 나타내며, 실제 실행을 나타내지는 않습니다. 정지 이미지: cbm_max_file_bytes 주변의 두 의존성 계층.

Explore. IDE 스타일 워크스페이스에서 파일을 탐색하고, Monaco에서 구문 강조된 소스를 읽으며, 코드 그래프를 나란히 유지하세요. File impact는 열린 파일에 의존하는 항목을 보여주고, Code details는 커서 아래 심볼의 호출자와 호출을 보여줍니다. 코드를 선택하여 로컬 채팅에 질문하세요.

더 많은 뷰: 시스템 구조와 동작
System structure는 심볼을 컴포넌트로 그룹화하고 그 의존성을 검사할 수 있게 합니다.

Behavior는 선택한 작업에서 가능한 호출과 그 뒤의 소스 근거를 보여줍니다.

고해상도 GIF는 2026년 10월 20일 CBM Lens Beta를 보여주며, 정지 이미지는 10월 12–13일에 캡처되었습니다. 모두 이 저장소의 공개 소스를 보여줍니다. 각 캡처의 빌드, 인덱싱 범위, 녹화 설정은 캡처 세부 정보를 참조하세요.

codebase-memory-mcp를 사용하는 이유

컨텍스트와 함께 올바른 코드 찾기: 심볼, 텍스트, 시맨틱 검색을 호출자, 의존성, 소스 스니펫, 파일 개요와 결합하세요. 대상 지정 쿼리와 간결한 페이지 결과는 토큰 사용과 반복적인 파일 읽기를 줄일 수 있습니다. 범위가 지정된 측정은 Performance를 참조하세요.
문서를 구현과 연결하기: 문서 섹션, PDF 텍스트 페이지, 아키텍처 결정, 지원되는 참조를 코드로 인덱싱하세요. 심볼 옆에서 설명을 찾으세요.
소스 파일 너머로 시스템 추적하기: Docker, Kubernetes, Helm, Kustomize, Terraform/OpenTofu, Terragrunt, Ansible, 스크립트, Make, CI 구성을 통해 지원되는 관계를 추적하세요.
실행 전에 변경 이해하기: 영향을 받는 심볼을 검사하고, 인덱싱된 스냅샷을 비교하며, 관련 테스트를 찾으세요. 실험적 Smart CI는 지원되는 C/C++ 테스트 하네스에 대해 정적 관계와 테스트별 커버리지를 결합하며, 근거가 불충분할 때는 더 넓은 실행으로 폴백합니다.
CBM Lens Beta로 시각적으로 탐색하기: 소스를 읽고, 호출 경로를 따라가고, 아키텍처와 커버리지 격차를 검사하고, 아키텍처 결정을 관리하며, 선택한 코드에 대해 로컬 모델에 질문하세요.
코딩 에이전트 장비하기: 설치 시 지원되는 클라이언트 구성, 지속적인 가이던스, 스킬, 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로 시작하세요. Nix 패키지와 소스 빌드는 UI가 없는 빌드도 제공합니다.

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=<path>(사용자 지정 위치).

바이러스 백신 참고: Microsoft Defender가 릴리스 바이너리를 Trojan:Script/Wacatac.B!ml로 표시할 수 있습니다. 이는 알려진 오탐이며, 일반적으로 ~62개 엔진 중 61개가 깨끗함을 반환하고, 동일한 탐지 계열이 gh, llama.cpp, Godot 및 Microsoft 자체 Go 툴체인에도 나타납니다. 근거, 아티팩트를 직접 검증하는 방법, 우리가 틀렸다고 생각할 경우 보고하는 방법은 Antivirus False Positives를 참조하세요.

코딩 에이전트를 재시작하세요. "이 프로젝트를 인덱싱해"라고 말하세요: 완료.

수동 설치

최신 릴리스에서 플랫폼용 아카이브를 다운로드하세요:

codebase-memory-mcp-<os>-<arch>.tar.gz(macOS/Linux) 또는 .zip(Windows)

압축을 풀고 설치하세요(각 아카이브에는 install.sh 또는 install.ps1이 포함됨):

macOS / Linux:

tar xzf codebase-memory-mcp- * .tar.gz
./install.sh
Windows(PowerShell):

Expand-Archive codebase - memory - mcp - windows - amd64.zip - DestinationPath .
Unblock-File .\install.ps1
.\install.ps1

코딩 에이전트를 재시작하세요.

install 명령은 macOS 격리 속성을 자동으로 제거하고 바이너리에 ad-hoc 서명을 합니다. 수동 xattr / codesign이 필요하지 않습니다.

에이전트 설정: 스킬, 프로필, 훅
설치 시 지원되는 코딩 에이전트가 일상 업무에서 그래프를 사용할 수 있도록 준비합니다. 네이티브 install 명령은 클라이언트를 감지하고 문서화된 형식이 지원하는 통합 요소를 설치합니다:

구성 요소
추가되는 내용

MCP 구성
클라이언트를 로컬 서버와 그 도구에 연결합니다.

지침 및 스킬
그래프 우선 탐색, 인덱스 최신성, 커버리지 검사, 소스를 읽어야 할 시점을 설명합니다.

Scout, Verify, Auditor 프로필
사용자 지정 에이전트가 지원되는 곳에서 빠른 잠정 조회, 작업 지향 검증, 또는 제한된 전체 검증을 제공합니다.

세션 및 컴팩션 훅
지원되는 라이프사이클 이벤트에서 그래프 컨텍스트를 복원합니다.

검색 및 읽기 훅
지원되는 검색에 관련 그래프 컨텍스트를 추가하고, 지원되는 파일 읽기 후 기록된 커버리지 격차를 표시합니다.

훅 보강은 컨텍스트 전용이며 fail-open입니다. 요청된 도구 호출을 대체하거나 차단하지 않습니다. 기능은 클라이언트와 플랫폼에 따라 다릅니다. 일부 클라이언트는 훅이나 직접 서브에이전트 MCP 액세스 대신 지속적인 지침이나 상위 에이전트 핸드오프를 사용합니다. Codex 사용자는 /hooks를 통해 설치된 훅을 검토하고 신뢰합니다. 정확한 지원과 활성화 요구 사항은 Multi-Agent Support 및 Sessions, compaction, and subagents를 참조하세요.

세션 조정 데몬
CBM은 Claude Code, Codex, OpenCode 및 기타 구성된 모든 클라이언트에 걸쳐 계정당 하나의 조정 데몬을 자동으로 공유합니다. MCP 서버나 훅 클라이언트에 대한 옵트인 설정은 없습니다. 첫 번째 데몬 기반 CBM 세션이 이를 시작하고, 각 세션은 자체 작업을 등록하며, 세션 관리 데몬은 마지막 세션 후 중지됩니다. daemon start로 시작된 데몬은 중지될 때까지 계속 실행됩니다. 데몬은 워처, 공유 인덱싱 작업, 선택적 UI와 같은 장기 백그라운드 서비스를 소유합니다. 한 세션을 닫으면 해당 세션만 소유한 작업이 취소되지만, 다른 세션에 여전히 필요한 작업은 계속됩니다.

분리된 데몬은 MCP 프론트엔드의 stderr에 의존하지 않습니다. 정규 ${CBM_CACHE_DIR}/logs 디렉터리(기본값 ~/.cache/codebase-memory-mcp/logs) 아래에 소유자 전용 영구 기록을 유지합니다:

파일
내용

cbm-daemon.log
데몬 라이프사이클, 워처/인덱싱, UI, 리소스, 오류 이벤트.

daemon-conflicts.ndjson
정확한 빌드, 조정 ABI, 캐시 루트 승인 충돌.

activation-events.ndjson
설치/업데이트/제거 활성화 진행 상황과 결과.

씬 프론트엔드는 여전히 즉각적인 시작 및 세션별 오류를 자체 stderr에 기록하며, MCP JSON-RPC stdout은 깨끗하게 유지됩니다.

모든 활성 CBM 프로세스는 정확히 동일한 버전, 실행 파일 빌드, 조정 ABI, 정규 캐시 루트에서 실행되어야 합니다. 동등한 CBM_CACHE_DIR 별칭은 동일한 루트로 해석되며, 실제로 다른 루트는 CBM 프로세스가 활성 상태인 동안 거부됩니다. MCP 서버, 훅, 일회성 CLI 명령, 임시 인덱스 워커, 데몬은 충돌 안전 OS 승인 배리어를 공유합니다. 일반적인 충돌 프로세스를 시작하면 작업을 수행하기 전에 실패하고 ${CBM_CACHE_DIR}/logs/daemon-conflicts.ndjson에 명시적 충돌을 기록합니다.

네이티브 install 및 uninstall 명령은 이 충돌 규칙의 의도적 예외입니다. 설치의 경우 다운로드, 검증, 비공개 동일 파일 시스템 스테이징이 활성화 전에 완료되어 잘못된 후보가 활성 작업을 방해하지 않습니다. 네이티브 update 명령은 업데이트를 수행하는 설치 프로그램 명령을 출력합니다. 그런 다음 활성화는 계정 전체 유지 관리 의도를 게시하고, 데몬과 모든 임시 로컬 작업에 취소를 요청하며, 모든 조정된 CBM 프로세스가 종료될 때까지 유한 기한까지 기다립니다. 활성 바이너리, 구성, PATH 또는 인덱스를 변경하는 동안 승인 및 수명 배리어를 독점적으로 보유합니다. 이 기간 동안 새로운 CBM 작업은 진입할 수 없습니다. 활성화 진행 상황과 결과는 ${CBM_CACHE_DIR}/logs/activation-events.ndjson에 기록되며, 성공한 명령은 활성화된 빌드를 실행하도록 열린 코딩 에이전트 세션을 재시작하라고 알려줍니다.

패키지 관리자 설정(npm, PyPI, Go)은 해당 패키지의 네이티브 실행 파일을 검증하고 캐시합니다. 활성 네이티브 설치를 대체하지 않으므로 실행 중인 CBM 세션을 중지하지 않습니다. 해당 캐시된 바이너리가 실행될 때 여전히 동일한 정확한 빌드 승인 배리어에 진입합니다. 셸 및 PowerShell 설치 프로그램은 검증된 후보의 네이티브 install 명령을 호출하므로 전체 계정 전체 활성화 보장을 받습니다.

일반 cli 모드는 하나의 명령을 로컬에서 실행하지만 위의 데몬과 분리되어 있지 않습니다. 동일한 승인 배리어와 그래프 변경에 대한 프로젝트별 잠금을 위해 공유 조정 데몬에 연결합니다(실행 중인 데몬이 없으면 시작). 그 연결은 cli_session입니다. 프로젝트 워처를 등록하거나 브라우저를 열지 않으며, 명령 수명 동안만 승인 리스를 보유합니다. 공유 데몬은 UI 구성과 사용 가능한 자산에 따라 Lens를 제공할 수 있습니다. 만약…