概要
Spec Workflow MCP(Pimzino/spec-workflow-mcp)は、AI エージェントに 仕様駆動開発 の進め方を持ち込む MCP サーバーである。要件 → 設計 → タスクの順に文書を作り、その一つひとつを専用の画面で人間が承認し、記録を残すのが最大の特徴。スラッシュコマンドやスキルとして入るほかの SDD ツールと違い、MCP に対応したエージェント(Claude Code・Cursor・Codex など)ならほぼ同じ設定で使える。
ライセンスはほかの SDD ツールと違い GPL-3.0。使うだけなら影響は小さいが、改変して配布するなら条件を確かめる。
詳細
導入
claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project
npx -y @pimzino/spec-workflow-mcp@latest --dashboard --port 5000 # ダッシュボードは別に起動
Claude Desktop・Cursor・Cline は mcpServers の JSON、Codex は ~/.codex/config.toml の [mcp_servers.spec-workflow] に同じ引数で書く。ダッシュボードのポートは README とドキュメントで既定の説明が食い違うので --port で明示する。ダッシュボードは 1 つで複数プロジェクトを表示できる。
仕様づくりと承認
チャットで「Create a spec for user authentication」「Execute task 1.2 in spec user-auth」のように頼むと、エージェントは MCP サーバーが提供する手順に従って文書を作り、承認の依頼が自動で出る。人間はダッシュボードか VS Code 拡張で Approve(承認)/Request Changes(コメント付きで修正依頼)/Reject(要件からやり直し) を選ぶ。チャットで「OK」と返すのではなく、承認が記録として残る。
現在のソースで登録されている MCP ツールは spec-workflow-guide・steering-guide・spec-status・approvals・log-implementation の 5 つ(ドキュメントのツール一覧はこれより多く、ソースと合っていない)。
作られるファイル
| 置き場所 | 内容 |
|---|---|
.spec-workflow/specs/<仕様名>/ | requirements.md・design.md・tasks.md |
.spec-workflow/steering/ | product.md・tech.md・structure.md |
.spec-workflow/templates/ | 差し替え可能なテンプレート |
.spec-workflow/archive/ | 完了した仕様 |
文書構成は Kiro とよく似ている。
ダッシュボードと VS Code 拡張
Web ダッシュボードは進行中の仕様・タスク数・完了率、各文書、タスクを実装させるプロンプトのコピー、承認操作を WebSocket でリアルタイムに表示する。既定は 127.0.0.1 で待ち受ける。VS Code 拡張(Pimzino.spec-workflow-mcp)はサイドバーでほぼ同等の操作ができ、仕様のアーカイブなどダッシュボードにない機能もある。
使う前の注意点(2026 年 11 月時点)
- メンテナンス休止中:作者が個人的な理由で離れている旨が README の冒頭にあり、最後の push は 2026 年 7 月
- npm の版に最新の修正がない:
@latestで入るのは 2.2.5(2026 年 3 月)。CHANGELOG の 2.2.7(承認カテゴリのパストラバーサル修正、simple-git の深刻な脆弱性対応)は npm 未公開 - ダッシュボードに HTTPS と認証がない:
127.0.0.1のまま使い、外部に公開しない - ドキュメントの一部が古い:ツール一覧やポートの説明が実装と合わない
承認を画面で記録できる仕組みは魅力だが、業務で使うならこれらを踏まえてリスクを判断する。承認の記録が欲しいだけなら、承認を git タグで残してスクリプトで照合する 要求仕様書作成ループ のような方法もある。
関連ページ
- 仕様駆動開発(SDD) — ツール比較と選び方
- MCP (Model Context Protocol) — このツールが乗るプロトコル
- Kiro — よく似た文書構成の AI IDE
- cc-sdd / GitHub Spec Kit — スキル・コマンド型の SDD ツール
- Claude Code —
claude mcp addで登録する