Repolode
DeusData

DeusData/codebase-memory-mcp

코드, 문서, 인프라를 로컬 지식 그래프로 인덱싱해 AI 코딩 에이전트가 파일을 다시 읽는 대신 구조를 질의할 수 있게 하는 MCP 서버입니다.

스타
47,045
포크
3,863
열린 이슈
622
마지막 커밋
9시간 전

어떤 프로젝트인가요?

codebase-memory-mcp는 저장소에서 지속적으로 유지되는 로컬 지식 그래프를 구축하는 네이티브 C MCP 서버입니다. vendored tree-sitter 문법으로 소스 코드를 파싱하고, 호출·import·상속 관계를 통해 심볼을 연결하며, Markdown과 PDF 문서는 물론 Docker, Kubernetes, Helm, Terraform, Ansible 및 CI 설정도 그래프에 연결합니다. 코딩 에이전트는 17개의 MCP 도구를 통해 호출자, 의존성, 변경 영향 또는 배포 경로를 질의하거나 CLI에서 그래프를 직접 조회할 수 있습니다.

인덱싱과 질의는 호스팅 서비스나 API 키 없이 모두 로컬 머신에서 실행됩니다. 포함된 시맨틱 검색은 바이너리에 컴파일된 임베딩 모델을 사용합니다. 설치 프로그램은 Claude Code, Codex, Cursor, Windsurf 같은 지원 에이전트 클라이언트를 설정하고, 각 클라이언트가 지원하는 경우 지침, 스킬, 훅을 추가합니다.

CBM Lens는 그래프를 아키텍처 맵, 3D 호출 그래프 뷰, 커버리지 진단 기능이 있는 소스 리더로 시각화하는 선택형 브라우저 인터페이스로, 현재 오픈 베타입니다. 기기에서 실행되는 모델을 사용해 선택한 코드에 관한 질문에 답하는 로컬 채팅 기능도 포함합니다.

핵심 기능

  • 01구조 검색, 호출 추적, 아키텍처 요약, 변경 영향 분석을 위한 17개의 MCP 도구를 제공합니다.
  • 02vendored tree-sitter 문법으로 다양한 언어를 파싱하고 파일 간 호출 관계를 해석합니다.
  • 03Markdown, PDF, ADR 문서를 해당 문서에서 참조하는 코드 심볼과 연결합니다.
  • 04Docker, Kubernetes, Helm, Terraform, Ansible의 관계를 소스 코드에 매핑합니다.
  • 05외부 API나 서비스 없이 시맨틱 검색, BM25 검색, 구조 검색을 실행합니다.
  • 06지원되는 45개 클라이언트 통합을 위한 MCP 설정과 에이전트 스킬을 설치합니다.

활용 사례

  • AI 코딩 에이전트가 많은 파일을 다시 읽지 않고도 익숙하지 않은 대규모 코드베이스를 탐색하도록 지원합니다.
  • Kubernetes 또는 Terraform 변경이 어떤 서비스와 이미지에 영향을 미치는지 추적합니다.
  • 커밋하지 않은 변경 사항이 영향을 줄 수 있는 심볼과 테스트를 추정합니다.
  • CBM Lens 인터페이스로 저장소의 아키텍처를 시각적으로 탐색합니다.

빠른 시작

  1. 1

    README에 있는 macOS 또는 Linux용 공식 설치 스크립트를 실행합니다

  2. 2

    코딩 에이전트를 다시 시작합니다

  3. 3

    에이전트에게 프로젝트를 인덱싱해 달라고 요청합니다

  4. 4

    원한다면 비주얼 컴패니언인 CBM Lens를 시작합니다

    codebase-memory-mcp daemon start --open --port=9749

사용 전 알아둘 점

  • 비주얼 컴패니언인 CBM Lens는 오픈 베타(v0.0.1)입니다.
  • 일부 환경에서는 Windows 설치 시 PowerShell 실행 정책 우회가 필요합니다.
  • Microsoft Defender가 Windows 릴리스 바이너리를 오탐할 수 있습니다.

토픽

자주 묻는 질문

codebase-memory-mcp은(는) 무엇인가요?
코드, 문서, 인프라를 로컬 지식 그래프로 인덱싱해 AI 코딩 에이전트가 파일을 다시 읽는 대신 구조를 질의할 수 있게 하는 MCP 서버입니다. codebase-memory-mcp는 저장소에서 지속적으로 유지되는 로컬 지식 그래프를 구축하는 네이티브 C MCP 서버입니다. vendored tree-sitter 문법으로 소스 코드를 파싱하고, 호출·import·상속 관계를 통해 심볼을 연결하며, Markdown과 PDF 문서는 물론 Docker, Kubernetes, Helm, Terraform, Ansible 및 CI 설정도 그래프에 연결합니다. 코딩 에이전트는 17개의 MCP 도구를 통해 호출자, 의존성, 변경 영향 또는 배포 경로를 질의하거나 CLI에서 그래프를 직접 조회할 수 있습니다.
codebase-memory-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
codebase-memory-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
codebase-memory-mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. codebase-memory-mcp의 마지막 커밋은 2026년 10월 21일입니다.
codebase-memory-mcp은(는) 어디에 사용할 수 있나요?
AI 코딩 에이전트가 많은 파일을 다시 읽지 않고도 익숙하지 않은 대규모 코드베이스를 탐색하도록 지원합니다. Kubernetes 또는 Terraform 변경이 어떤 서비스와 이미지에 영향을 미치는지 추적합니다. 커밋하지 않은 변경 사항이 영향을 줄 수 있는 심볼과 테스트를 추정합니다. CBM Lens 인터페이스로 저장소의 아키텍처를 시각적으로 탐색합니다.
codebase-memory-mcp는 어떻게 설치하나요?
README에 있는 macOS 또는 Linux용 공식 설치 스크립트를 실행합니다 코딩 에이전트를 다시 시작합니다 에이전트에게 프로젝트를 인덱싱해 달라고 요청합니다 원한다면 비주얼 컴패니언인 CBM Lens를 시작합니다: codebase-memory-mcp daemon start --open --port=9749
codebase-memory-mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/DeusData/codebase-memory-mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트