Skip to main content
Glama
deenesjakoruzh
VelimirMueller

code-context-mcp

by VelimirMueller
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

vlm-code-context-mcp

Memoria persistente para agentes de programación con IA.

Tus agentes olvidan todo entre sesiones. Esto lo soluciona.

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

Tres comandos. Cero claves API. Un archivo context.db.

Benchmark

Probado en 10 tareas de desarrollo reales (recuperación, depuración, refactorización, implementación), y luego validado con 200 pruebas aleatorias y una prueba de rangos con signo de Wilcoxon.

MCP

Vanilla

Ahorro

Tokens

4,806

8,726

44.9%

Llamadas a herramientas

49

68

27.9%

Tasa de éxito estocástico

—

—

90.5% (p < 0.001)

Las herramientas MCP devuelven resúmenes estructurados (exportaciones, dependencias, rol del archivo) en lugar del contenido bruto del archivo. Los agentes leen menos, saben más.

# 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

Metodología completa en BENCHMARK-GUIDE.md.

Related MCP server: code-tree-mcp

Inicio rápido

1 · Instalar

npm install vlm-code-context-mcp

2 · Inicializar

npx code-context-mcp setup .

Crea context.db, indexa tu base de código, configura un equipo de 7 agentes y escribe .mcp.json.

3 · Reinicia tu cliente de IA

Reinicia Claude Code (o cualquier cliente MCP). Verifica con get_project_status.

4 · Inicia el panel de control

npx code-context-dashboard ./context.db

Se abre en http://localhost:3333 con actualizaciones SSE en tiempo real. Para reindexar automáticamente al guardar archivos:

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

5 · Ejecuta tu primer sprint

Escribe en Claude Code:

/kickoff

El orquestador te guía a través de visión → descubrimiento → hito → épicas → tickets → sprint → implementación → retrospectiva, una pregunta a la vez. La reanudación inteligente te permite detenerte y continuar más tarde.

Panel de control

7 páginas. Actualizaciones SSE en tiempo real. Cero sondeos.

Página

Qué muestra

Dashboard

Tablero Kanban, paso a paso de fases, burndown, velocidad, lista de verificación del sprint

Planning

Rastreador de hitos, progreso de épicas, canal de descubrimiento

Code

Árbol de archivos, grafo de dependencias, mapa de exportación/importación, historial de cambios

Team

Tarjetas de agentes, insignias de modelos, tendencias de estado de ánimo, barras de carga de trabajo

Retro

Perspectivas en cuadrícula Bento, patrones entre sprints, temas recurrentes

Benchmark

Comparación MCP vs Vanilla con métricas animadas

Velocity

Tendencias sprint a sprint, comprometido vs completado

Cada mutación de la base de datos activa una actualización instantánea mediante el monitoreo WAL de SQLite.

Comandos de barra (Slash Commands)

Escríbelos directamente en Claude Code.

Comando

Qué hace

/kickoff

Ciclo de vida guiado completo: de la visión a la retrospectiva. Empieza aquí.

/sprint

Bucle exclusivo de sprint: planificar → implementar → QA → retrospectiva → archivar

/ticket

Mueve tickets a través de su ciclo de vida con contexto completo

/milestone

Crea, actualiza y cierra hitos con verificación de épicas

/retro

Retrospectivas basadas en datos con análisis de burndown + velocidad

/sprint-connect

Conecta la interfaz del panel de control con tu sesión de Claude

Cómo funciona

Cada comando sigue el mismo patrón: cargar contexto desde la base de datos antes de hacer nada.

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

Ningún agente mantiene el proyecto completo en su ventana de contexto. Consultan lo que necesitan de un cerebro SQLite compartido y escriben los resultados de vuelta.

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

El equipo de agentes

9 agentes configurables, cada uno con un rol, modelo y puntuación de estado de ánimo.

Rol

Enfoque

Product Owner

Visión, prioridades, alineación de partes interesadas

Team Lead

Coordinación, revisión de código, calidad

Architect

Diseño de sistemas, decisiones tecnológicas, integridad estructural

Backend Developer

APIs, base de datos, lógica del servidor

Frontend Developer

Componentes del panel, UI/UX

Developer

Funciones full-stack en frontend y backend

QA Engineer

Pruebas, verificación, puertas de calidad

Security Engineer

Revisión de vulnerabilidades, modelado de amenazas, mejores prácticas de seguridad

DevOps

CI/CD, compilaciones, despliegue

Agrega, elimina o intercambia modelos a través de herramientas MCP o con un solo clic en el panel de control.

Proceso de Sprint

4 fases con verificaciones de puerta forzadas:

planning → implementation → done → rest

Fase

Duración

Puerta

Planning

1 día

Tickets asignados, velocidad comprometida

Implementation

3 días

Todos los tickets HECHOS o NO_HECHOS, bloqueadores resueltos

Done

0.5 día

Hallazgos de la retrospectiva registrados, QA verificado

Rest

0.5 día

Automático después de la retrospectiva

Las fases, duraciones y puertas son totalmente personalizables mediante update_sprint_config.

Stack tecnológico

Capa

Tecnología

Runtime

Node.js 24 LTS

Database

SQLite mediante better-sqlite3, modo WAL

MCP protocol

@anthropic-ai/sdk

Dashboard

React 19 + Vite + Zustand + Framer Motion

Styling

Variables CSS + Tailwind, tema oscuro

Live updates

SSE mediante observador de archivos WAL

Testing

Vitest

Build

TypeScript modo estricto

Números del motor

Componente

Cantidad

Herramientas MCP

76 (32 lectura + 44 escritura)

Tablas de base de datos

30 (25 scrum + 5 código)

Componentes React

62

Roles de agente

9 (configurables)

Fases de sprint

4 con verificaciones de puerta

Comandos de barra

6

Configuración manual del servidor MCP

Si la configuración automática de .mcp.json no funciona:

# 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

Desarrollo

# MCP server
npm run dev

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

Licencia

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