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

Related MCP server: CODING DevOps MCP Server

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;
  };
}