概要
Spec Workflow MCPは、Model Context Protocol（MCP）を基盤とした開発支援サーバーで、AI駆動型の仕様ベース開発ワークフローを実現します。背景には「仕様書とコードが常にズレていく」という開発チームの古くからの課題があります。このツールはそうした問題を根本から解決するため、仕様をAIの文脈に組み込み、Web ダッシュボードとVSCode拡張でリアルタイムに進捗を管理できる統合プラットフォームとして設計されました。
主な機能
- MCPサーバー統合 - LLMが常に最新の仕様定義にアクセスでき、文脈に基づいた正確なコード生成・ドキュメント作成が可能になる
- リアルタイムWebダッシュボード - プロジェクトの実装進捗、仕様の進捗状況、AI生成タスクの履歴が一画面で可視化される
- VSCode拡張 - エディタを離れず仕様確認・進捗更新ができ、開発フローの中断を最小化する
- 仕様駆動開発ワークフロー - 仕様ファイル（マークダウンやJSON）からテストコード・実装スケルトン・ドキュメントを自動生成
- 進捗トラッキング - 仕様項目ごとに実装状況を記録し、チーム全体で開発状況を共有できる
- AIアシスタント連携 - Claude、GPT-4などのLLMと直接連携し、仕様解釈から実装支援まで自動化
- マルチプロジェクト管理 - 複数のプロジェクトを一元管理し、チームメンバー間の責任分担を可視化
技術スタック
- バックエンド - Node.js / TypeScript（MCPサーバー実装）
- フロントエンド - React / Next.js（Webダッシュボード）
- エディタ拡張 - Visual Studio Code Extension API
- AI連携 - OpenAI API, Claude API（LLM連携）
- データ管理 - JSON/マークダウンベースの仕様ファイル
- 通信プロトコル - Model Context Protocol（標準化されたAI-ツール間通信）
- 開発ツール - Git, npm/yarn（パッケージ管理）
導入方法
- リポジトリのクローン
git clone https://github.com/Pimzino/spec-workflow-mcp.git cd spec-workflow-mcp - 依存パッケージのインストール
npm install - 環境設定
.env.exampleをコピーして.envを作成- OpenAI API キーまたはClaude API キーを設定
- MCPサーバーの起動
npm run start:server - Webダッシュボードの起動
npm run start:dashboard - VSCode拡張のインストール
- VSCodeで拡張機能パネルを開く → “spec-workflow-mcp” を検索 → インストール
- または、ローカル開発は
npm run dev:extensionで実行可能
競合比較
| 機能 | Spec Workflow MCP | GitHub Copilot | Cursor IDE | Swimm |
|---|---|---|---|---|
| 仕様ファイルとの統合 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| Webダッシュボード | ⭐⭐⭐⭐⭐ | ❌ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| VSCode統合 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 進捗トラッキング | ⭐⭐⭐⭐⭐ | ❌ | ⭐⭐ | ⭐⭐⭐⭐ |
| MCPプロトコル対応 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| オープンソース | ⭐⭐⭐⭐⭐ | ❌ | ❌ | ❌ |
差別化ポイント
Spec Workflow MCPの最大の強みは、MCPという標準プロトコルを採用することで、複数のLLM（Claude、GPT-4、ローカルモデル等）を柔軟に切り替えられる点です。仕様駆動開発をさらに推進したい場合はClaude Code Spec Workflow：仕様駆動開発でClaude Code 使い方を活かし設計から実装まで自動化も合わせて確認してください。MCPサーバーの一元管理にはMCP Manager：MCPサーバー 作り方から一元管理まで対応するAIアシスタント統合管理ツールが有効です。また、GitHub CopilotやCursorは「コード補完」が中心ですが、このツールは「仕様→実装→テスト→ドキュメント」の全フローを仕様駆動で回すワークフロー管理に特化しています。さらにWebダッシュボードとVSCode拡張で、個人開発からチーム開発まで規模に応じた柔軟な運用が可能な点も、他ツールにない利点です。
こんな人におすすめ
- スタートアップ・小規模チームのエンジニア - 少数精鋭で高速開発する必要があり、仕様管理とAI支援の両立で生産性を最大化したい
- AI時代の開発ワークフローを試したい開発者 - LLMの力を活かしつつ、仕様駆動開発を実践し、ChatGPT/Claude時代の新しい開発スタイルを体験したい
- 仕様書と実装の乖離に困っているレガシー保守チーム - 昔の仕様書をデジタル化し、現在のコードとの同期を取り、メンテナンス品質を向上させたい
- チーム開発での進捗管理を効率化したいリーダー・マネージャー - VSCodeダッシュボードで全員の実装進捗をリアルタイムに把握し、ボトルネック検出や指示出しを迅速化したい
- オープンソースで拡張可能なツールを求めるエンジニア - 既存のクローズドツールに依存せず、MCPの標準プロトコルに基づくカスタマイズ可能な環境を構築したい