sdlc-workflow-mcp

Ein eigenständiger stdio-Model Context Protocol-Server, der einen begrenzten, fiktiven Datenausschnitt der SDLC-Workflow-Tools für die lokale Copilot-Nutzung bereitstellt.

Herkunft: extrahiert aus Tingsum26/sdlc-agent-platform unter dem Tag seven-repo-split-baseline (Commit bf48e15), Quellpfad apps/workflow-mcp. Dieses Repository ist ein Teil des Sieben-Repository-Splits, der in der Plattform-BOM (docs/platform-bom.yaml) beschrieben ist.

Was dies ist

• Ein TypeScript-MCP-Server (stdio-Transport), der einen begrenzten Satz von Workflow-Tools über HTTP an einen lokalen Workflow-Service weiterleitet.

• Alle Testdaten sind fiktiv (example.invalid, REPO_A, DEMO-123, EPIC-DEMO-1, fiktive Identitäten). Es gibt keinen Modell-Client, keine Anmeldeinformationen und keine echten Unternehmensdaten in diesem Teil.

Was dies nicht ist (registrierte Lücke)

Der vollständige genehmigte Tool-Katalog in der Plattform-BOM ist größer als dieser Teil. Dieses Repository registriert nur die Teilmenge, die zum Zeitpunkt des Splits im vertikalen Slice apps/workflow-mcp implementiert wurde (Workflow-Aufgaben, Internal-Readiness, Epic/Ticket/Repo-Task, Change-Request und Journey-Tools). Die übrigen Katalog-Tools werden in der ursprünglichen Plattform-BOM und ihrer Migrationszuordnung nachverfolgt, nicht hier.

Voraussetzungen

• Node.js >= 20.19.0

• pnpm

Build und Test

pnpm install
pnpm build
pnpm test

Starten des stdio-Servers

Der Server benötigt eine Workflow-Service-URL und spricht MCP über stdio:

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

Umgebungsvariablen:

Bei einem Startfehler oder fehlender Konfiguration schreibt der Server eine strukturierte JSON-Diagnose auf stderr und beendet sich mit Exit-Code 2.

Aufbau

• src/ — MCP-Server, API-Client, Diagnose und Tool-Registrierung.

• test/ — Vitest-Suite mit Abdeckung von Tool-Erkennung, Korrelations-IDs, Audit-Sichtbarkeit, sicherer Fehlerzuordnung, Abbruch und stderr-Schwärzung.