Skip to main content
Glama

🧠 CodeMemory

코드베이스를 위한 영구 지능 계층
로컬 우선, 프라이버시 중심의 CLI 도구이자 AI 에이전트용 Model Context Protocol (MCP) 서버입니다.

🌐 공식 웹사이트 및 문서: https://codemem.vercel.app/


⚡ 주요 특징

  • 🔒 100% 로컬 및 프라이빗: 제로 텔레메트리, 제로 외부 네트워크 호출. 모든 지능은 SQLite WAL 모드로 로컬에 저장됩니다.

  • 🌐 인터랙티브 웹 아키텍처 탐색기: 타임라인 스크러빙과 실시간 라이브 업데이트를 지원하는 로컬 시각적 플로우차트 및 메모리 대시보드.

  • ⚡ 토큰 효율성: 원시 파일 덤프 대신 타겟팅된 컨텍스트 슬라이스와 호출자 그래프를 제공하여 AI 프롬프트 토큰 소비를 최소화합니다.

  • 🔍 다중 언어 AST 분석: TypeScript/JavaScript, Python, Rust, Go, SQL 등에서 함수, 클래스, 인터페이스, 구조체, 임포트를 추출합니다.

  • 👀 실시간 라이브 워처: 100ms 디바운싱과 .gitignore 통합으로 코드 변경을 즉시 감지합니다.

  • 🤖 네이티브 MCP 서버: Antigravity, Claude Desktop, Cursor, Copilot 및 사용자 정의 AI 에이전트와 연결할 준비가 되어 있습니다.

  • 📊 아키텍처 비주얼라이저: 실시간 Mermaid 다이어그램, Markdown 문서, JSON 맵을 생성합니다.


Related MCP server: ContextAtlas

🚀 빠른 시작

1. 설치

# Clone the repository
git clone https://github.com/EldrexDelosReyesBula/CodeMemory.git
cd CodeMemory

# Install dependencies
npm install

# Build TypeScript
npm run build

2. 기본 명령어

# Initialize CodeMemory in your repository
npm run dev -- init

# Scan the current codebase and index all symbols
npm run dev -- scan

# Search for any function, class, or symbol
npm run dev -- query authenticateUser

# Extract token-budgeted AI context
npm run dev -- context AuthService --budget 2000

# Start the live background file watcher
npm run dev -- watch

# Export Mermaid architecture diagram
npm run dev -- export --format mermaid

# Check repository health and statistics
npm run dev -- status

🤖 MCP를 통한 AI 에이전트 연결

CodeMemory는 완전한 Model Context Protocol (MCP) stdio 서버를 제공합니다.

사용 가능한 MCP 도구

도구

설명

codememory_search

코드 심볼, 시그니처, 함수 검색

codememory_get_context

의존성 및 호출자를 포함한 토큰 예산 컨텍스트

codememory_get_dependencies

업스트림 임포트 및 다운스트림 의존자

codememory_get_history

최근 파일 수정 및 Git 커밋 로그

codememory_get_architecture

실시간 Mermaid 아키텍처 다이어그램 생성

codememory_get_metrics

전체 코드베이스 통계 및 언어별 분석

Antigravity 및 Claude Desktop 설정

MCP 구성(mcp_config.json 또는 claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "codememory": {
      "command": "node",
      "args": ["c:/Users/Eldrex/Downloads/classhost/Needs/CodeMemory/dist/cli.js", "mcp"],
      "env": {}
    }
  }
}

🏗️ 아키텍처

CodeMemory/
├── src/
│   ├── types/          # Domain data types & contracts
│   ├── db/             # SQLite engine with WAL mode & indexes
│   ├── parser/         # Multi-language AST symbol & dependency extractor
│   ├── watcher/        # Real-time debounced file watcher with .gitignore
│   ├── git/            # Git commit and diff history monitor
│   ├── generator/      # Mermaid diagram & Markdown/JSON exporters
│   ├── context/        # Token-budgeted context assembly & symbol ranker
│   ├── mcp/            # Model Context Protocol stdio server
│   └── cli.ts          # CLI commands router
└── tests/              # Complete Vitest test suite

📜 라이선스

MIT License - Copyright (c) 2026 Eldrex Delos Reyes Bula.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Local-first codebase context engine that parses code into a ranked dependency graph and serves it to AI tools via MCP for deep structural understanding.
    5
    4 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
    29
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Serves structured code context via MCP, enabling AI agents to understand codebases with dependency graphs and significantly reduce token usage.
    14 npm
    1
    MIT