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: PAELLADOC

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

1. Enmarcado de mensajes

   • Protocolo basado en la longitud del contenido

   • Manejo confiable de límites de mensajes

   • Gestión de buffer

2. Capa de transporte

   • Comunicación basada en sockets TCP

   • Gestión de conexiones

   • Arquitectura basada en eventos

3. Gestión de sesiones

   • Seguimiento de sesiones de clientes

   • Negociación de capacidades

   • Persistencia del estado

4. Registro de herramientas

   • Registro dinámico de herramientas

   • Validación de entrada

   • Formato de resultados

Herramientas

1. Gestión de proyectos

   • Crear/Obtener proyectos

   • Puntos de control del proyecto

   • Restauración del estado

2. Gestión de paquetes de trabajo

   • Crear/Obtener paquetes de trabajo

   • Seguimiento del progreso

   • Actualizaciones de estado

3. Gestión de tareas

   • Crear/actualizar tareas

   • Seguimiento de cambios de archivos

   • Puntos de control de tareas

4. 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

1. El cliente se conecta a través de TCP

2. El cliente envía una solicitud de inicialización

3. El servidor responde con capacidades

4. Comienza el intercambio normal de mensajes

5. El cliente puede apagar/salir

Desarrollo

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

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Licencia ISC