sdlc-workflow-mcp

Un servidor independiente de Model Context Protocol (stdio) que expone un subconjunto acotado de datos ficticios de las herramientas de flujo de trabajo SDLC para uso local con Copilot.

Procedencia: extraído de Tingsum26/sdlc-agent-platform en la etiqueta seven-repo-split-baseline (commit bf48e15), ruta de origen apps/workflow-mcp. Este repositorio es un subconjunto de la división en siete repositorios descrita en el BOM de la plataforma (docs/platform-bom.yaml).

Qué es esto

• Un servidor MCP de TypeScript (transporte stdio) que actúa como proxy de un conjunto acotado de herramientas de flujo de trabajo hacia un Workflow Service local a través de HTTP.

• Todos los datos de ejemplo son ficticios (example.invalid, REPO_A, DEMO-123, EPIC-DEMO-1, identidades ficticias). No hay cliente de modelo, ni credenciales, ni datos reales de empresa en este subconjunto.

Qué no es esto (brecha registrada)

El catálogo completo de herramientas aprobadas en el BOM de la plataforma es mayor que este subconjunto. Este repositorio registra únicamente el subconjunto implementado en el corte vertical apps/workflow-mcp en el momento de la división (workflow tasks, internal-readiness, epic/ticket/repo-task, change-request y journey tools). Las herramientas restantes del catálogo se gestionan en el BOM de la plataforma de origen y en su mapa de migración, no aquí.

Requisitos previos

• Node.js >= 20.19.0

• pnpm

Compilación y pruebas

pnpm install
pnpm build
pnpm test

Inicio del servidor stdio

El servidor requiere una URL de Workflow Service y habla MCP a través de stdio:

pnpm install
pnpm build
WORKFLOW_SERVICE_URL=http://127.0.0.1:8080 node dist/index.js

Variables de entorno:

Ante un fallo de inicio o una configuración incompleta, el servidor escribe un diagnóstico JSON estructurado en stderr y termina con el código 2.

Estructura

• src/ — servidor MCP, cliente de API, diagnósticos y registro de herramientas.

• test/ — suite de vitest que cubre el descubrimiento de herramientas, IDs de correlación, visibilidad de auditoría, mapeo seguro de errores, cancelación y redacción de stderr.