Skip to main content
Glama
deenesjakoruzh
VelimirMueller

code-context-mcp

by VelimirMueller
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

vlm-code-context-mcp

AI 코딩 에이전트를 위한 영구 메모리.

에이전트는 세션 간의 모든 것을 잊어버립니다. 이 도구가 그 문제를 해결합니다.

License: MIT npm version npm downloads

npm install vlm-code-context-mcp
npx code-context-mcp setup .
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db

세 가지 명령어. 제로 API 키. 하나의 context.db 파일.

벤치마크

10개의 실제 개발 작업(검색, 디버깅, 리팩토링, 구현)에 대해 테스트한 후, 200개의 무작위 시행과 윌콕슨 부호 순위 검정(Wilcoxon signed-rank test)으로 검증했습니다.

MCP

Vanilla

절감

토큰

4,806

8,726

44.9%

도구 호출

49

68

27.9%

확률적 승률

—

—

90.5% (p < 0.001)

MCP 도구는 원시 파일 내용 대신 구조화된 요약(내보내기, 의존성, 파일 역할)을 반환합니다. 에이전트는 더 적게 읽고 더 많이 알게 됩니다.

# Deterministic — 10 tasks, 6 categories
npm test -- test/benchmark.test.ts

# Stochastic — 200 randomized trials, Wilcoxon test, bootstrap CI
npm test -- test/benchmark-stochastic.test.ts

전체 방법론은 BENCHMARK-GUIDE.md에서 확인하세요.

Related MCP server: code-tree-mcp

빠른 시작

1 · 설치

npm install vlm-code-context-mcp

2 · 초기화

npx code-context-mcp setup .

context.db를 생성하고, 코드베이스를 인덱싱하며, 7명의 에이전트 팀을 구성하고, .mcp.json을 작성합니다.

3 · AI 클라이언트 재시작

Claude Code(또는 모든 MCP 클라이언트)를 재시작합니다. get_project_status로 확인하세요.

4 · 대시보드 실행

npx code-context-dashboard ./context.db

실시간 SSE 업데이트와 함께 http://localhost:3333에서 열립니다. 파일 저장 시 자동 재인덱싱을 하려면:

npx code-context-dashboard ./context.db 3333 .

5 · 첫 번째 스프린트 실행

Claude Code에 입력하세요:

/kickoff

오케스트레이터가 비전 → 발견 → 마일스톤 → 에픽 → 티켓 → 스프린트 → 구현 → 회고 과정을 한 번에 한 질문씩 안내합니다. 스마트 재개 기능을 통해 멈췄다가 나중에 다시 시작할 수 있습니다.

대시보드

7개의 페이지. 실시간 SSE 업데이트. 폴링 없음.

페이지

표시 내용

대시보드

칸반 보드, 단계별 게이트, 번다운, 속도, 스프린트 체크리스트

계획

마일스톤 추적기, 에픽 진행 상황, 발견 파이프라인

코드

파일 트리, 의존성 그래프, 내보내기/가져오기 맵, 변경 이력

팀

에이전트 카드, 모델 배지, 분위기 추세, 작업량 막대

회고

벤토 그리드 인사이트, 스프린트 간 패턴, 반복되는 주제

벤치마크

애니메이션 메트릭이 포함된 MCP 대 Vanilla 비교

속도

스프린트별 추세, 커밋된 작업 대 완료된 작업

모든 데이터베이스 변경은 SQLite WAL 모니터링을 통해 즉시 새로고침을 트리거합니다.

슬래시 명령어

Claude Code에 직접 입력하세요.

명령어

기능

/kickoff

비전부터 회고까지 전체 가이드 라이프사이클. 여기서 시작하세요.

/sprint

스프린트 전용 루프 — 계획 → 구현 → QA → 회고 → 아카이브

/ticket

전체 컨텍스트와 함께 티켓을 라이프사이클에 따라 이동

/milestone

에픽 검증과 함께 마일스톤 생성, 업데이트, 종료

/retro

번다운 + 속도 분석을 포함한 데이터 기반 회고

/sprint-connect

대시보드 UI를 Claude 세션에 연결

작동 원리

모든 명령어는 동일한 패턴을 따릅니다: 무엇을 하기 전에 데이터베이스에서 컨텍스트를 로드합니다.

search_files("auth middleware")       → find the right file
get_file_context("src/auth.ts")      → understand role, exports, dependents
Read("src/auth.ts")                  → only now read the actual code

어떤 에이전트도 전체 프로젝트를 컨텍스트 창에 유지하지 않습니다. 공유된 SQLite 브레인에서 필요한 것을 쿼리하고 결과를 다시 기록합니다.

┌─────────────────────────────────────────────────────┐
│               Claude Code / MCP Client              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐          │
│  │ /kickoff │  │ /sprint  │  │ /ticket  │  ...     │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘          │
│       └──────────────┼─────────────┘                │
│                      ▼                              │
│              76 MCP Tools                           │
│          (32 read + 44 write)                       │
│                      │                              │
│                      ▼                              │
│  ┌─────────────────────────────────────┐            │
│  │       context.db (SQLite)           │            │
│  │  30 tables · WAL mode · <5ms reads  │            │
│  └──────────────────┬──────────────────┘            │
│                     │ WAL watcher                   │
│                     ▼                               │
│  ┌─────────────────────────────────────┐            │
│  │    React Dashboard (Vite)           │            │
│  │  62 components · SSE live updates   │            │
│  └─────────────────────────────────────┘            │
└─────────────────────────────────────────────────────┘

에이전트 팀

각각 역할, 모델, 분위기 점수를 가진 9개의 구성 가능한 에이전트.

역할

초점

제품 책임자

비전, 우선순위, 이해관계자 조정

팀 리더

조정, 코드 리뷰, 품질

아키텍트

시스템 설계, 기술 결정, 구조적 무결성

백엔드 개발자

API, 데이터베이스, 서버 로직

프론트엔드 개발자

대시보드 컴포넌트, UI/UX

개발자

프론트엔드 및 백엔드 전반의 풀스택 기능

QA 엔지니어

테스트, 검증, 품질 게이트

보안 엔지니어

취약점 검토, 위협 모델링, 보안 모범 사례

데브옵스

CI/CD, 빌드, 배포

MCP 도구를 통해 또는 대시보드에서 클릭 한 번으로 모델을 추가, 제거 또는 교체하세요.

스프린트 프로세스

강제 게이트 체크가 포함된 4단계:

planning → implementation → done → rest

단계

기간

게이트

계획

1일

티켓 할당, 속도 커밋

구현

3일

모든 티켓 DONE 또는 NOT_DONE, 차단 요소 해결

완료

0.5일

회고 결과 기록, QA 검증

휴식

0.5일

회고 후 자동

단계, 기간 및 게이트는 update_sprint_config를 통해 완전히 사용자 정의할 수 있습니다.

기술 스택

레이어

기술

런타임

Node.js 24 LTS

데이터베이스

SQLite (better-sqlite3 사용), WAL 모드

MCP 프로토콜

@anthropic-ai/sdk

대시보드

React 19 + Vite + Zustand + Framer Motion

스타일링

CSS 변수 + Tailwind, 다크 테마

실시간 업데이트

WAL 파일 감시자를 통한 SSE

테스트

Vitest

빌드

TypeScript strict 모드

엔진 수치

구성 요소

개수

MCP 도구

76 (32 읽기 + 44 쓰기)

데이터베이스 테이블

30 (25 스크럼 + 5 코드)

React 컴포넌트

62

에이전트 역할

9 (구성 가능)

스프린트 단계

4 (게이트 체크 포함)

슬래시 명령어

6

수동 MCP 서버 설정

자동 .mcp.json 설정이 작동하지 않는 경우:

# Add to current project
claude mcp add code-context npx -y vlm-code-context-mcp ./context.db

# Add globally
claude mcp add --scope user code-context node /path/to/node_modules/vlm-code-context-mcp/dist/server/index.js ./context.db

# Remove
claude mcp remove code-context

개발

# MCP server
npm run dev

# Dashboard (Vite dev server with HMR)
npm run dashboard:dev

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • local-code-intel-mcp

    tungvt93
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides code intelligence by indexing source code into SQLite and offering MCP tools for symbol search, flow tracing, and context retrieval to assist with code navigation and understanding.
    -

  • code-tree-mcp

    markgregg
    F
    license
    B
    quality
    C
    maintenance
    An MCP server that indexes source code into a local database and provides tools for querying code symbols, dependencies, and tree structure for JavaScript/TypeScript, Java, and Python.
    7
    -

  • code-graph-mcp

    dorkian
    A
    license
    A
    quality
    B
    maintenance
    Indexes a mono-repo into a knowledge graph and provides MCP tools to query code structure—packages, components, routes, HTTP calls—without file reads or grep round-trips.
    7
    22
    MIT

  • codegraph-mcp

    SiwarKhalfaoui
    A
    license
    A
    quality
    C
    maintenance
    An MCP server that indexes TypeScript/JavaScript codebases into precise call and import graphs using the TypeScript compiler API, allowing Claude or any MCP client to query definitions, callers, callees, and perform impact analysis.
    7
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VelimirMueller/vlm-code-context-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server