Servidor MCP del administrador de contexto

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para administrar el contexto y el flujo de trabajo de desarrollo.

Características

Transporte basado en sockets con enmarcado de mensajes confiable
Compatibilidad total con el protocolo JSON-RPC 2.0
Gestión de sesiones con negociación de capacidades
Sistema de registro de herramientas extensible
Gestión de proyectos, paquetes de trabajo y tareas
Funcionalidad de punto de control y restauración
Soporte del flujo de trabajo de revisión de control de calidad

Configuración inicial

# Install dependencies
npm install

# First-time build
npm run build

Uso

Iniciando el servidor

# Development mode (no build required, uses tsx for on-the-fly compilation)
npm run dev

# Production mode (requires build)
npm start

# Start with debug logging
DEBUG=1 npm run dev

# Start on specific port
MCP_PORT=44558 npm run dev

Modo de desarrollo

# Run with hot reloading (preferred during development)
npm run dev

# Watch mode for TypeScript compilation (if you prefer running the compiled version)
npm run watch

# In a separate terminal when using watch mode
npm start

Comienzo limpio

Si encuentra algún problema, puede intentar una compilación limpia:

# Remove build artifacts
rm -rf dist/

# Reinstall dependencies
npm ci

# Rebuild the project
npm run build

# Start in development mode
npm run dev

Arquitectura

Componentes principales

Enmarcado de mensajes
- Protocolo basado en la longitud del contenido
- Manejo confiable de límites de mensajes
- Gestión de buffer
Capa de transporte
- Comunicación basada en sockets TCP
- Gestión de conexiones
- Arquitectura basada en eventos
Gestión de sesiones
- Seguimiento de sesiones de clientes
- Negociación de capacidades
- Persistencia del estado
Registro de herramientas
- Registro dinámico de herramientas
- Validación de entrada
- Formato de resultados

Herramientas

Gestión de proyectos
- Crear/Obtener proyectos
- Puntos de control del proyecto
- Restauración del estado
Gestión de paquetes de trabajo
- Crear/Obtener paquetes de trabajo
- Seguimiento del progreso
- Actualizaciones de estado
Gestión de tareas
- Crear/actualizar tareas
- Seguimiento de cambios de archivos
- Puntos de control de tareas
Herramientas de control de calidad
- Revisar el flujo de trabajo
- Arreglar solicitudes
- Aceptación del paquete de trabajo

Configuración

Variables de entorno:

DEBUG : Habilitar el registro de depuración (0/1)
MCP_PORT : Puerto del servidor (predeterminado: 44557)

Protocolo

El servidor implementa el Protocolo de Contexto de Modelo con JSON-RPC 2.0:

interface MCPMessage {
  jsonrpc: "2.0";
  id: number;
  method?: string;      // for requests
  params?: any;         // for requests
  result?: any;         // for responses
  error?: {             // for error responses
    code: number;
    message: string;
    data?: any;
  };
}

Flujo de mensajes

El cliente se conecta a través de TCP
El cliente envía una solicitud de inicialización
El servidor responde con capacidades
Comienza el intercambio normal de mensajes
El cliente puede apagar/salir

Desarrollo

Consulte las secciones Configuración inicial y Modo de desarrollo más arriba.

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Licencia ISC

Context Manager MCP Server

Integrations