sdlc-workflow-mcp

ローカルでの Copilot 使用のために、SDLC ワークフローツールの限定された架空データのスライスを公開する、スタンドアロンの stdio Model Context Protocol サーバーです。

出典: Tingsum26/sdlc-agent-platform の seven-repo-split-baseline タグ(コミット bf48e15)から抽出。ソースパスは apps/workflow-mcp です。このリポジトリは、プラットフォーム BOM(docs/platform-bom.yaml)に記載されている 7 リポジトリ分割の 1 スライスです。

これは何か

• 限定された一連のワークフローツールを、HTTP 経由でローカルの Workflow Service にプロキシする TypeScript MCP サーバー(stdio トランスポート)。

• すべてのフィクスチャは架空のものです(example.invalid、REPO_A、DEMO-123、EPIC-DEMO-1、架空の ID)。このスライスには、モデルクライアント、認証情報、実際の会社データは一切含まれません。

これは何ではないか(登録済みギャップ)

プラットフォーム BOM に記載されている承認済みツールカタログの全体は、このスライスよりも大きいものです。このリポジトリが登録するのは、分割時点で apps/workflow-mcp の垂直スライスに実装されていたサブセットのみです(workflow tasks、internal-readiness、epic/ticket/repo-task、change-request、journey tools)。残りのカタログツールは、ここではなく、元のプラットフォーム 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 スイート。