Skip to main content
Glama
deenesjakoruzh
VelimirMueller

code-context-mcp

by VelimirMueller
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

vlm-code-context-mcp

Permanenter Speicher für KI-Coding-Agenten.

Deine Agenten vergessen alles zwischen den Sitzungen. Das hier behebt das.

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

Drei Befehle. Null API-Schlüssel. Eine context.db-Datei.

Benchmark

Getestet anhand von 10 realen Entwicklungsaufgaben (Abruf, Debugging, Refactoring, Implementierung), dann validiert mit 200 randomisierten Versuchen und einem Wilcoxon-Vorzeichen-Rang-Test.

MCP

Vanilla

Ersparnis

Tokens

4.806

8.726

44,9%

Tool-Aufrufe

49

68

27,9%

Stochastische Gewinnrate

—

—

90,5% (p < 0,001)

MCP-Tools geben strukturierte Zusammenfassungen (Exporte, Abhängigkeiten, Dateifunktion) anstelle von rohem Dateiinhalt zurück. Agenten lesen weniger, wissen mehr.

# 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

Vollständige Methodik in BENCHMARK-GUIDE.md.

Related MCP server: code-tree-mcp

Schnellstart

1 · Installieren

npm install vlm-code-context-mcp

2 · Initialisieren

npx code-context-mcp setup .

Erstellt context.db, indiziert deine Codebasis, setzt ein 7-Agenten-Team auf und schreibt .mcp.json.

3 · Starte deinen KI-Client neu

Starte Claude Code (oder einen beliebigen MCP-Client) neu. Überprüfe es mit get_project_status.

4 · Starte das Dashboard

npx code-context-dashboard ./context.db

Öffnet sich unter http://localhost:3333 mit Live-SSE-Updates. Um bei Dateispeicherung auch automatisch neu zu indizieren:

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

5 · Starte deinen ersten Sprint

Gib in Claude Code ein:

/kickoff

Der Orchestrator führt dich durch Vision → Discovery → Meilenstein → Epics → Tickets → Sprint → Implementierung → Retro — eine Frage nach der anderen. Mit der intelligenten Fortsetzungsfunktion kannst du stoppen und später weitermachen.

Dashboard

7 Seiten. Live-SSE-Updates. Kein Polling.

Seite

Was sie zeigt

Dashboard

Kanban-Board, Phasen-Stepper, Burndown, Velocity, Sprint-Checkliste

Planung

Meilenstein-Tracker, Epic-Fortschritt, Discovery-Pipeline

Code

Dateibaum, Abhängigkeitsgraph, Export/Import-Karte, Änderungshistorie

Team

Agentenkarten, Modell-Badges, Stimmungstrends, Arbeitslast-Balken

Retro

Bento-Grid-Einblicke, Sprint-übergreifende Muster, wiederkehrende Themen

Benchmark

MCP vs. Vanilla Vergleich mit animierten Metriken

Velocity

Sprint-für-Sprint-Trends, geplant vs. abgeschlossen

Jede Datenbankänderung löst eine sofortige Aktualisierung über die SQLite-WAL-Überwachung aus.

Slash-Befehle

Gib diese direkt in Claude Code ein.

Befehl

Was er bewirkt

/kickoff

Vollständiger geführter Lebenszyklus — von Vision bis Retro. Hier starten.

/sprint

Nur-Sprint-Schleife — planen → implementieren → QA → retro → archivieren

/ticket

Tickets mit vollem Kontext durch ihren Lebenszyklus bewegen

/milestone

Meilensteine erstellen, aktualisieren, schließen mit Epic-Verifizierung

/retro

Datenbasierte Retrospektiven mit Burndown + Velocity-Analyse

/sprint-connect

Verbinde die Dashboard-UI mit deiner Claude-Sitzung

Funktionsweise

Jeder Befehl folgt dem gleichen Muster: Lade den Kontext aus der Datenbank, bevor du irgendetwas tust.

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

Kein Agent hält das gesamte Projekt in seinem Kontextfenster. Sie fragen ab, was sie aus einem gemeinsamen SQLite-Gehirn benötigen, und schreiben die Ergebnisse zurück.

┌─────────────────────────────────────────────────────┐
│               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   │            │
│  └─────────────────────────────────────┘            │
└─────────────────────────────────────────────────────┘

Das Agenten-Team

9 konfigurierbare Agenten, jeder mit einer Rolle, einem Modell und einem Stimmungs-Score.

Rolle

Fokus

Product Owner

Vision, Prioritäten, Stakeholder-Abstimmung

Team Lead

Koordination, Code-Review, Qualität

Architect

Systemdesign, Technologieentscheidungen, strukturelle Integrität

Backend Developer

APIs, Datenbank, Server-Logik

Frontend Developer

Dashboard-Komponenten, UI/UX

Developer

Full-Stack-Funktionen über Frontend und Backend hinweg

QA Engineer

Tests, Verifizierung, Qualitäts-Gates

Security Engineer

Schwachstellen-Review, Bedrohungsmodellierung, Sicherheits-Best-Practices

DevOps

CI/CD, Builds, Deployment

Füge Modelle hinzu, entferne oder tausche sie über MCP-Tools oder mit einem einzigen Klick im Dashboard aus.

Sprint-Prozess

4 Phasen mit erzwungenen Gate-Checks:

planning → implementation → done → rest

Phase

Dauer

Gate

Planung

1 Tag

Tickets zugewiesen, Velocity zugesagt

Implementierung

3 Tage

Alle Tickets DONE oder NOT_DONE, Blocker gelöst

Fertig

0,5 Tage

Retro-Ergebnisse aufgezeichnet, QA verifiziert

Pause

0,5 Tage

Automatisch nach Retro

Phasen, Dauern und Gates sind über update_sprint_config vollständig anpassbar.

Tech-Stack

Schicht

Technologie

Laufzeit

Node.js 24 LTS

Datenbank

SQLite via better-sqlite3, WAL-Modus

MCP-Protokoll

@anthropic-ai/sdk

Dashboard

React 19 + Vite + Zustand + Framer Motion

Styling

CSS-Variablen + Tailwind, Dark Theme

Live-Updates

SSE via WAL-Datei-Watcher

Tests

Vitest

Build

TypeScript Strict Mode

Engine-Zahlen

Komponente

Anzahl

MCP-Tools

76 (32 Lesen + 44 Schreiben)

Datenbanktabellen

30 (25 Scrum + 5 Code)

React-Komponenten

62

Agentenrollen

9 (konfigurierbar)

Sprint-Phasen

4 mit Gate-Checks

Slash-Befehle

6

Manuelle MCP-Server-Einrichtung

Falls die automatische .mcp.json-Einrichtung nicht funktioniert:

# 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

Entwicklung

# MCP server
npm run dev

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

Lizenz

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

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
    D
    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
    C
    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 npm
    MIT

  • Codebase Intelligence MCP

    S-naruka
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that indexes a local Python codebase into a SQLite graph for hybrid code search, file context, lazy explanations, dependency traces, and version-aware symbol history.
    MIT