GitHub Trending기타

DeusData/codebase-memory-mcp

Linux 커널을 3분에 인덱싱하는 AI 코드 분석 엔진

원제 DeusData/codebase-memory-mcp

스타 44,745당일 +190C
Key Point

AI 에이전트가 대규모 코드베이스를 밀리초 단위로 이해할 수 있게 하는 기술로, 토큰 비용을 99% 줄이면서도 코드 구조를 정확히 분석하는 실용적인 솔루션이다.

핵심 요약

  • codebase-memory-mcp는 코드베이스를 지속형 지식 그래프로 변환하는 MCP 서버로, 평균 저장소는 밀리초 단위로, Linux 커널(28M LOC, 75K 파일)은 3분에 인덱싱한다.
  • 158개 언어를 지원하며 tree-sitter AST 분석과 Python, TypeScript, Go, Java, Rust 등 12개 언어에 대한 하이브리드 LSP 의미론 분석으로 함수, 클래스, HTTP 경로, 서비스 간 연결을 매핑한다.
  • 구조적 쿼리에 1ms 이하로 응답하며, 파일 단위 탐색 대비 99.2% 토큰 절감(5개 쿼리당 3,400 vs 412,000 토큰)을 달성한다.
  • Docker, 언어 런타임, API 키 불필요한 단일 정적 바이너리로 배포되며, macOS(arm64/amd64), Linux(arm64/amd64), Windows(amd64)에 native executable로 제공된다.
  • LZ4 압축과 메모리 내 SQLite를 통한 RAM 우선 파이프라인으로 인덱싱 후 메모리를 OS에 반환하며, 17개 MCP 도구로 아키텍처 분석, 영향도 추적, 데드코드 감지, 교차 서비스 HTTP 연결 등을 지원한다.
  • Claude Code, Codex, OpenCode 등 45개 지원 클라이언트에 플러그앤플레이 설정되며, 설치 스크립트가 자동 감지하고 조건부 클라이언트를 안전하게 활성화한다.
  • localhost:9749에서 3D 대화형 그래프 시각화를 제공하는 UI가 바이너리에 내장되어 있고, 세션 조정 데몬이 여러 에이전트 간 장기 서비스(감시자, 공유 인덱싱, UI)를 관리한다.
  • Docker 파일, Kubernetes 매니페스트, Kustomize 오버레이를 그래프 노드로 인덱싱하며, 교차 저장소 지능으로 여러 저장소에 걸친 서비스, 경로, 의존성을 연결할 수 있다.
  • 팀 공유용으로 압축된 지식 그래프 아티팩트(.codebase-memory/graph.db.zst)를 저장소에 커밋하면 팀원들이 재인덱싱을 건너뛰고, 로컬 변경사항은 증분 인덱싱으로 채워진다.
  • 100% 로컬 처리로 코드, 쿼리, 환경, 사용 기록이 머신을 벗어나지 않으며, 네트워크 요청이나 백그라운드 버전 체크가 없다.
  • npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR에서 배포되고, 백그라운드 감시자가 파일 변경을 감지해 자동 재인덱싱하며, LLM은 포함하지 않고 MCP 클라이언트의 AI를 쿼리 변환기로 활용한다.
  • arXiv 논문에서 31개 실제 저장소 평가 결과 83% 답변 품질, 10배 적은 토큰, 파일별 탐색 대비 2.1배 적은 도구 호출을 보고했다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗