Provides support link for the project through Buy Me A Coffee donation platform
Features embedded YouTube video demonstrations showcasing the approval system and dashboard functionality
Spec Workflow MCP
A Model Context Protocol (MCP) server that provides structured spec-driven development workflow tools for AI-assisted software development, featuring a real-time web dashboard for monitoring and managing your project's progress.
📺 Showcase
🔄 Approval System in Action
See how the approval system works: create documents, request approval through the dashboard, provide feedback, and track revisions.
📊 Dashboard & Spec Management
Explore the real-time dashboard: view specs, track progress, navigate documents, and monitor your development workflow.
☕ Support This Project
Features
- Structured Development Workflow - Sequential spec creation (Requirements → Design → Tasks)
- Real-Time Web Dashboard - Monitor specs, tasks, and progress with live updates
- Document Management - View and manage all spec documents from the dashboard
- Task Progress Tracking - Visual progress bars and detailed task status
- Steering Documents - Project vision, technical decisions, and structure guidance
- Bug Workflow - Complete bug reporting and resolution tracking
- Template System - Pre-built templates for all document types
- Cross-Platform - Works on Windows, macOS, and Linux
Quick Start
- Add to your AI tool configuration (see MCP Client Setup below):
- Start using the workflow:
- Use
spec-workflow-guide
tool first to understand the complete process - Use
steering-guide
tool to create project steering documents (optional) - Monitor progress via the automatic web dashboard (opens automatically for each project)
- Use
Note: The dashboard automatically opens in your browser when you start the MCP server. If it does not open automatically or you are running on a headless system, you can retrieve the dashboard URL from the session.json
file located in the .spec-workflow
directory of your project.
How to Use
You can simply mention spec-workflow or whatever name you gave the MCP server in your conversation. The AI will handle the complete workflow automatically or you can use some of the example prompts below:
Creating Specs
- "Create a spec for user authentication" - Creates complete spec workflow for that feature
- "Create a spec called payment-system" - Builds full requirements → design → tasks
- "Build a spec for @prd" - Takes your existing PRD and creates the complete spec workflow from it
- "Create a spec for shopping-cart - include add to cart, quantity updates, and checkout integration" - Detailed feature spec
Getting Information
- "List my specs" - Shows all specs and their current status
- "Show me the user-auth progress" - Displays detailed progress information
Implementation
- "Execute task 1.2 in spec user-auth" - Runs a specific task from your spec
- Copy prompts from dashboard - Use the "Copy Prompt" button in the task list on your dashboard
The agent automatically handles approval workflows, task management, and guides you through each phase.
MCP Client Setup
Claude Desktop
Add to claude_desktop_config.json
:
Cursor IDE
Add to your Cursor settings (settings.json
):
Claude Code CLI
Add to your MCP configuration:
Augment Code
Configure in your Augment settings:
Continue IDE Extension
Add to your Continue configuration:
Cline/Claude Dev
Add to your MCP server configuration:
Note: Replace
/path/to/your/project
with the actual path to your project directory where you want the spec workflow to operate.
Available Tools
Workflow Guides
spec-workflow-guide
- Complete guide for the spec-driven workflow processsteering-guide
- Guide for creating project steering documents
Spec Management
create-spec-doc
- Create/update spec documents (requirements, design, tasks)spec-list
- List all specs with status informationspec-status
- Get detailed status of a specific specmanage-tasks
- Comprehensive task management for spec implementation
Context & Templates
get-template-context
- Get markdown templates for all document typesget-steering-context
- Get project steering context and guidanceget-spec-context
- Get context for a specific spec
Steering Documents
create-steering-doc
- Create project steering documents (product, tech, structure)
Approval System
request-approval
- Request user approval for documentsget-approval-status
- Check approval statusdelete-approval
- Clean up completed approvals
Web Dashboard
The server includes a real-time web dashboard that automatically opens in your browser when you start the MCP server. Each project gets its own dedicated dashboard running on an ephemeral port. The dashboard provides:
- Live Project Overview - Real-time updates of specs and progress
- Document Viewer - Read requirements, design, and tasks documents
- Task Progress Tracking - Visual progress bars and task status
- Steering Documents - Quick access to project guidance
- Dark Mode - Automatically enabled for better readability
Dashboard Features
- Spec Cards - Overview of each spec with status indicators
- Document Navigation - Switch between requirements, design, and tasks
- Task Management - View task progress and copy implementation prompts
- Real-Time Updates - WebSocket connection for live project status
Workflow Process
1. Project Setup (Recommended)
Creates foundational documents to guide your project development.
2. Feature Development
Sequential process: Requirements → Design → Tasks → Implementation
3. Implementation Support
- Use
get-spec-context
for detailed implementation context - Use
manage-tasks
to track task completion - Monitor progress via the web dashboard
File Structure
Development
Troubleshooting
Common Issues
- Dashboard not opening automatically
- The dashboard uses ephemeral ports and opens automatically when the MCP server starts
- Check console output for the dashboard URL if it doesn't open in your browser
- MCP server not connecting
- Verify the file paths in your configuration are correct
- Ensure the project has been built with
npm run build
- Check that Node.js is available in your system PATH
- Dashboard not updating
- The dashboard uses WebSockets for real-time updates
- Refresh the browser if connection is lost
- Check console for any JavaScript errors
Getting Help
- Check the Issues page for known problems
- Create a new issue using the provided templates
- Use the workflow guides within the tools for step-by-step instructions
License
GPL-3.0
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides structured spec-driven development workflow tools for AI-assisted software development with sequential spec creation (Requirements → Design → Tasks). Features a real-time web dashboard for monitoring project progress and managing development workflows.
Related MCP Servers
- AsecurityFlicenseAqualityFacilitates AI session handoffs and next steps tracking through project-based organization, supporting task prioritization and seamless workflow management.Last updated -87JavaScript
- AsecurityAlicenseAqualityAn AI-powered automation tool development platform that provides modular architecture with tool hot-reloading, enterprise-grade integration capabilities, and real-time updates with zero-downtime deployment.Last updated -175TypeScriptMIT License
- AsecurityFlicenseAqualityAI-driven tool that helps developers create beautiful UI components instantly through natural language descriptions, integrating with popular IDEs like Cursor, Windsurf, and VSCode.Last updated -32
- AsecurityFlicenseAqualityA simple AI development tool that helps users interact with AI through natural language commands, offering 29 tools across thinking, memory, browser, code quality, planning, and time management capabilities.Last updated -312TypeScript