このプロジェクトについて
Spec Workflow MCPは、AI支援コーディングに構造化されたスペック駆動開発ワークフローを追加するModel Context Protocol(MCP)サーバーです。アシスタントが直接コードに飛びつくのではなく、要件、設計、タスクという順序立てられた仕様書を通じて作業を導きます。npmパッケージ(@pimzino/spec-workflow-mcp)として配布され、Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Continue、Augment Code、OpenCode、Codexなどのツール内でMCPサーバーとして設定されます。
READMEに記載されている主な機能は以下の通りです:
- 構造化ワークフロー:スペックは順序通り(要件→設計→タスク)に作成され、個々のタスクは会話プロンプトを通じて名前または番号で実行できます。
- リアルタイムWebダッシュボード:ダッシュボードプロセス(デフォルトポート5000)がスペック、タスク、進捗バー、ステータスをライブ更新で表示します。1つのダッシュボードインスタンスで複数のプロジェクトを提供できます。
- VSCode拡張機能:VSCodeユーザー向けの統合サイドバーダッシュボードで、Visual Studio Marketplaceで公開されています。
- 承認ワークフロー:ドキュメントはダッシュボードを通じて承認のために提出でき、フィードバックと改訂が追跡されます。
- タスク進捗追跡:視覚的な進捗インジケーターと詳細なタスクステータス。
- 実装ログ:コード統計を含むタスク実装の検索可能なログ。
- 多言語サポート:プロジェクトは11言語(英語、日本語、中国語、スペイン語、ポルトガル語、ドイツ語、フランス語、ロシア語、イタリア語、韓国語、アラビア語)でドキュメントを提供しています。
使用方法はプロンプト駆動です。ユーザーは会話でspec-workflowに言及してスペックの作成、スペックの一覧表示、特定のタスクの実行を行います。プロジェクトの状態は.spec-workflowディレクトリに保存され、承認、アーカイブ、スペック、ステアリング、テンプレート、ユーザーテンプレートが含まれます。
デプロイと運用:ダッシュボードは提供されたDockerfileとdocker-composeセットアップを使用してDockerで実行でき、.spec-workflowワークスペース用のボリュームマウントがあります。READMEのセキュリティノートには、サーバーがデフォルトで127.0.0.1にバインドされ、レート制限(クライアントあたり毎分120リクエスト)を適用し、構造化JSON監査ログを書き込み、セキュリティヘッダーを設定し、CORSをlocalhostに制限し、非rootユーザー、読み取り専用ファイルシステム、削除されたケーパビリティ、リソース制限でDockerイメージを強化することが記載されています。HTTPS/TLSとユーザー認証はまだ実装されていないと明示的にリストされ、外部アクセスにはリバースプロキシ(nginx/Apache)が推奨されています。$HOMEが読み取り専用のサンドボックス環境では、SPEC_WORKFLOW_HOME環境変数がグローバル状態を書き込み可能な場所にリダイレクトします。
開発はnpm(install、build、devスクリプト)で行われ、プロジェクトはGPL-3.0ライセンスです。READMEには、メンテナーがリポジトリから一時的に離れていることも記載されています。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.