Spec Workflow MCP Server is a structured development workflow tool for AI-assisted software projects that orchestrates the full development lifecycle through a sequential framework. It guides projects from requirements gathering through design documentation to actionable implementation tasks, complete with approval workflows and progress tracking. Key features: - Sequential spec creation workflow (Requirements → Design → Tasks) with structured document templates - Real-time web dashboard running on port 5000 with live updates and progress monitoring - VSCode extension with integrated sidebar dashboard for in-editor workflow management - Approval system with revision tracking, feedback management, and document status workflow - Visual task progress tracking with status bars, completion percentages, and detailed metrics - Searchable implementation logs capturing code statistics and task history - Multi-language support for 11 languages including Japanese, Chinese, Spanish, and German

Spec Workflow MCP

[](https://www.npmjs.com/package/@pimzino/spec-workflow-mcp) [](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)

A Model Context Protocol (MCP) server for structured spec-driven development with real-time dashboard and VSCode extension.

☕ Support This Project

📺 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.*

✨ Key Features

🌍 Supported Languages

🇺🇸 English • 🇯🇵 日本語 • 🇨🇳 中文 • 🇪🇸 Español • 🇧🇷 Português • 🇩🇪 Deutsch • 🇫🇷 Français • 🇷🇺 Русский • 🇮🇹 Italiano • 🇰🇷 한국어 • 🇸🇦 العربية

📖 Documentation in your language:

English | 日本語 | 中文 | Español | Português | Deutsch | Français | Русский | Italiano | 한국어 | العربية

🚀 Quick Start

Step 1: Add to your AI tool

Add to your MCP configuration (see client-specific setup below):

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

Step 2: Choose your interface

Option A: Web Dashboard (Required for CLI users) Start the dashboard (runs on port 5000 by default):

npx -y @pimzino/spec-workflow-mcp@latest --dashboard

The dashboard will be accessible at: http://localhost:5000

> Note: Only one dashboard instance is needed. All your projects will connect to the same dashboard.

Option B: VSCode Extension (Recommended for VSCode users)

Install Spec Workflow MCP Extension from the VSCode marketplace.

📝 How to Use

Simply mention spec-workflow in your conversation:

See more examples →

🔧 MCP Client Setup

Augment Code

Configure in your Augment settings:

{
  "mcpServers": {
    "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 @pimzino/spec-workflow-mcp@latest -- /path/to/your/project

Important Notes:

Alternative for Windows (if the above doesn't work):

claude mcp add spec-workflow cmd.exe /c "npx @pimzino/spec-workflow-mcp@latest /path/to/your/project"

Claude Desktop

Add to claude_desktop_config.json:

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

> Important: Run the dashboard separately with --dashboard before starting the MCP server.

Cline/Claude Dev