概要
Spec Workflow MCPは、Model Context Protocol（MCP）を基盤とした開発支援サーバーで、AI駆動型の仕様ベース開発ワークフローを実現します。背景には「仕様書とコードが常にズレていく」という開発チームの古くからの課題があります。例えば、ジュニアエンジニアのTさんが「APIの仕様は更新されたけど、テストコードが古いまま」という状況に陥り、デバッグに2日を費やしたケースも。このツールはそうした問題を根本から解決するため、仕様を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、ローカルモデル等）を柔軟に切り替えられる点です。また、GitHub CopilotやCursorは「コード補完」が中心ですが、このツールは「仕様→実装→テスト→ドキュメント」の全フローを仕様駆動で回すワークフロー管理に特化しています。さらにWebダッシュボードとVSCode拡張で、個人開発からチーム開発まで規模に応じた柔軟な運用が可能な点も、他ツールにない利点です。
活用シーン
シーン1: スタートアップのスピード開発
スタートアップのシニアエンジニア田中さんは、2名のジュニアエンジニアとの小規模チームです。仕様書は共有ドキュメントにあるものの、実装の誰が何をしているかが曖昧で、頻繁に重複開発が発生していました。このツール導入後、仕様ファイルをプロジェクトに置き、MCPで共有することで、AI（Claude）がその仕様に基づいて自動的にテストコードとスケルトン実装を生成。ダッシュボードで「あ、APIエンドポイントAはもう60%実装済み」が可視化され、ジュニアたちの進捗報告がワンクリックで完了。結果、スプリント内の実装生産性が4割向上し、仕様ズレによる手戻りがほぼゼロに。
シーン2: レガシーコード保守チーム
大企業の保守チーム担当者・鈴木さんは、10年モノのレガシーシステムの仕様書がpdfの紙資料のみという地獄の状況にありました。新しい機能追加の度に、老朽化したコードベースから動作を推測するしかなく、バグが頻発していました。このツールで、仕様書をマークダウンに起こしてMCPサーバーに登録。既存コードとの差分をAIに解析させることで、「実装が仕様から外れている箇所」を自動検出。保守作業の品質が向上し、インシデント対応時間が50%削減されました。
シーン3: 複数言語・複数チームの国際的なプロジェクト
グローバル企業の開発マネージャー・山田さんは、日本、シンガポール、ポーランドの3つのタイムゾーンにチームを抱えていました。仕様変更が日本で発生しても、欧州チームがそれを知らず、古い仕様で実装してしまう問題が常態化。このツール導入により、仕様ファイルの更新がリアルタイムにMCPを通じて全チームに共有され、ダッシュボード上で「どの仕様が更新されたか」が色付け表示。さらにVSCode拡張の多言語サポートで、母語での仕様確認も可能に。結果、仕様変更の見落としが99%削減され、国際チーム間のコミュニケーションコストが劇的に低下しました。
こんな人におすすめ
- スタートアップ・小規模チームのエンジニア - 少数精鋭で高速開発する必要があり、仕様管理とAI支援の両立で生産性を最大化したい
- AI時代の開発ワークフローを試したい開発者 - LLMの力を活かしつつ、仕様駆動開発を実践し、ChatGPT/Claude時代の新しい開発スタイルを体験したい
- 仕様書と実装の乖離に困っているレガシー保守チーム - 昔の仕様書をデジタル化し、現在のコードとの同期を取り、メンテナンス品質を向上させたい
- チーム開発での進捗管理を効率化したいリーダー・マネージャー - VSCodeダッシュボードで全員の実装進捗をリアルタイムに把握し、ボトルネック検出や指示出しを迅速化したい
- オープンソースで拡張可能なツールを求めるエンジニア - 既存のクローズドツールに依存せず、MCPの標準プロトコルに基づくカスタマイズ可能な環境を構築したい