Skip to main content
Glama

Spec Workflow MCP

by Pimzino

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

  1. Add to your AI tool configuration (see MCP Client Setup below):
    { "mcpServers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }
  2. 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)

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:

{ "mcpServers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }

Cursor IDE

Add to your Cursor settings (settings.json):

{ "mcp.servers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }

Claude Code CLI

Add to your MCP configuration:

claude mcp add spec-workflow npx "-y @pimzino/spec-workflow-mcp@latest /path/to/your/project"

Augment Code

Configure in your Augment settings:

{ "mcpServers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }

Continue IDE Extension

Add to your Continue configuration:

{ "mcpServers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }

Cline/Claude Dev

Add to your MCP server configuration:

{ "mcpServers": { "spec-workflow": { "command": "npx", "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"] } } }

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 process
  • steering-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 information
  • spec-status - Get detailed status of a specific spec
  • manage-tasks - Comprehensive task management for spec implementation

Context & Templates

  • get-template-context - Get markdown templates for all document types
  • get-steering-context - Get project steering context and guidance
  • get-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 documents
  • get-approval-status - Check approval status
  • delete-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

steering-guide → create-steering-doc (product, tech, structure)

Creates foundational documents to guide your project development.

2. Feature Development

spec-workflow-guide → create-spec-doc → [review] → implementation

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

your-project/ .spec-workflow/ steering/ product.md # Product vision and goals tech.md # Technical decisions structure.md # Project structure guide specs/ {spec-name}/ requirements.md # What needs to be built design.md # How it will be built tasks.md # Implementation breakdown approval/ {spec-name}/ {document-id}.json # Approval status tracking

Development

# Install dependencies npm install # Build the project npm run build # Run in development mode (with auto-reload) npm run dev # Start the production server npm start # Clean build artifacts npm run clean

Troubleshooting

Common Issues

  1. 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
  2. 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
  3. 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

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. 📺 Showcase
    1. 🔄 Approval System in Action
    2. 📊 Dashboard & Spec Management
  2. ☕ Support This Project
    1. Features
      1. Quick Start
        1. How to Use
          1. Creating Specs
          2. Getting Information
          3. Implementation
        2. MCP Client Setup
          1. Claude Desktop
          2. Cursor IDE
          3. Claude Code CLI
          4. Augment Code
          5. Continue IDE Extension
          6. Cline/Claude Dev
        3. Available Tools
          1. Workflow Guides
          2. Spec Management
          3. Context & Templates
          4. Steering Documents
          5. Approval System
        4. Web Dashboard
          1. Dashboard Features
        5. Workflow Process
          1. 1. Project Setup (Recommended)
          2. 2. Feature Development
          3. 3. Implementation Support
        6. File Structure
          1. Development
            1. Troubleshooting
              1. Common Issues
              2. Getting Help
            2. License

              Related MCP Servers

              • A
                security
                F
                license
                A
                quality
                Facilitates AI session handoffs and next steps tracking through project-based organization, supporting task prioritization and seamless workflow management.
                Last updated -
                8
                7
                JavaScript
              • A
                security
                A
                license
                A
                quality
                An 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 -
                17
                5
                TypeScript
                MIT License
                • Apple
              • A
                security
                F
                license
                A
                quality
                AI-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 -
                3
                2
              • A
                security
                F
                license
                A
                quality
                A 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 -
                31
                2
                TypeScript

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Pimzino/spec-workflow-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server