sdlc-workflow-mcp

로컬 Copilot 사용을 위해 SDLC 워크플로 도구의 제한된 가상 데이터 슬라이스를 노출하는 독립형 stdio Model Context Protocol 서버입니다.

출처: Tingsum26/sdlc-agent-platform 저장소의 seven-repo-split-baseline 태그(커밋 bf48e15)에서 추출되었으며, 소스 경로는 apps/workflow-mcp입니다. 이 저장소는 플랫폼 BOM에 설명된 7개 저장소 분할 중 하나의 슬라이스입니다. (docs/platform-bom.yaml).

이것이 무엇인가

• HTTP를 통해 로컬 Workflow Service에 제한된 워크플로 도구 세트를 프록시하는 TypeScript MCP 서버(stdio 전송)입니다.

• 모든 픽스처는 가상 데이터입니다(example.invalid, REPO_A, DEMO-123, EPIC-DEMO-1, 가상의 신원 정보). 이 슬라이스에는 모델 클라이언트, 자격 증명, 실제 회사 데이터가 없습니다.

이것이 아닌 것(등록된 격차)

플랫폼 BOM의 전체 승인 도구 카탈로그는 이 슬라이스보다 큽니다. 이 저장소는 분할 시점에 apps/workflow-mcp 수직 슬라이스에서 구현된 하위 집합(워크플로 작업, 내부 준비 상태, 에픽/티켓/저장소 작업, 변경 요청, 여정 도구)만 등록합니다. 나머지 카탈로그 도구는 원본 플랫폼 BOM과 해당 마이그레이션 맵에서 추적되며, 여기에는 포함되지 않습니다.

사전 요구 사항

• Node.js >= 20.19.0

• pnpm

빌드 및 테스트

pnpm install
pnpm build
pnpm test

stdio 서버 시작

서버는 Workflow Service URL이 필요하며 stdio를 통해 MCP를 사용합니다:

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

환경 변수:

시작 실패 또는 구성 누락 시 서버는 구조화된 JSON 진단 정보를 stderr에 기록하고 코드 2로 종료합니다.

구조

• src/ — MCP 서버, API 클라이언트, 진단, 도구 등록.

• test/ — 도구 검색, 상관관계 ID, 감사 가시성, 안전한 오류 매핑, 취소, stderr 마스킹을 다루는 vitest 스위트.