@pimzino/spec-workflow-mcp
Advanced tools
MCP server for spec-driven development workflow with real-time web dashboard
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 and VSCode extension for monitoring and managing your project's progress directly in your development environment.
See how the approval system works: create documents, request approval through the dashboard, provide feedback, and track revisions.
Explore the real-time dashboard: view specs, track progress, navigate documents, and monitor your development workflow.
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"]
}
}
}
With Auto-Started Dashboard (opens dashboard automatically with MCP server):
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project", "--AutoStartDashboard"]
}
}
}
With Custom Port:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project", "--AutoStartDashboard", "--port", "3456"]
}
}
}
Note: Can be used without path to your project, but some MCP clients may not start the server from the current directory.
Choose your interface:
# Dashboard only mode (uses ephemeral port)
npx -y @pimzino/spec-workflow-mcp@latest /path/to/your/project --dashboard
# Dashboard only with custom port
npx -y @pimzino/spec-workflow-mcp@latest /path/to/your/project --dashboard --port 3000
# View all available options
npx -y @pimzino/spec-workflow-mcp@latest --help
Command-Line Options:
--help - Show comprehensive usage information and examples--dashboard - Run dashboard-only mode (no MCP server)--AutoStartDashboard - Auto-start dashboard with MCP server--port <number> - Specify dashboard port (1024-65535). Works with both --dashboard and --AutoStartDashboardInstall the Spec Workflow MCP Extension from the VSCode marketplace:
.spec-workflow/Extension Features:
IMPORTANT: For CLI users, the web dashboard is mandatory. For VSCode users, the extension replaces the need for a separate web dashboard while providing the same functionality directly in your IDE.
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:
The agent automatically handles approval workflows, task management, and guides you through each phase.
Configure in your Augment settings:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
}
}
}
Add to your MCP configuration:
claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest /path/to/your/project
Note: You may need to wrap the command in cmd.exe /c "npx -y @pimzino/spec-workflow-mcp@latest /path/to/your/project" for Windows.
Add to claude_desktop_config.json:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
}
}
}
Or with auto-started dashboard:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project", "--AutoStartDashboard"]
}
}
}
Add to your MCP server configuration:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
}
}
}
Add to your Continue configuration:
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
}
}
}
Add to your Cursor settings (settings.json):
{
"mcp.servers": {
"spec-workflow": {
"command": "npx",
"args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
}
}
}
Add to your opencode.json configuration file (either global at ~/.config/opencode/opencode.json or project-specific):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"spec-workflow": {
"type": "local",
"command": ["npx", "-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"],
"enabled": true
}
}
}
Note: Replace
/path/to/your/projectwith the actual path to your project directory where you want the spec workflow to operate.
spec-workflow-guide - Complete guide for the spec-driven workflow processsteering-guide - Guide for creating project steering documentscreate-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 implementationget-template-context - Get markdown templates for all document typesget-steering-context - Get project steering context and guidanceget-spec-context - Get context for a specific speccreate-steering-doc - Create project steering documents (product, tech, structure)request-approval - Request user approval for documentsget-approval-status - Check approval statusdelete-approval - Clean up completed approvalsThe web dashboard is a separate service for CLI users. Each project gets its own dedicated dashboard running on an ephemeral port. The dashboard provides:
The VSCode extension provides all dashboard functionality directly within your IDE:
steering-guide → create-steering-doc (product, tech, structure)
Creates foundational documents to guide your project development.
spec-workflow-guide → create-spec-doc → [review] → implementation
Sequential process: Requirements → Design → Tasks → Implementation
get-spec-context for detailed implementation contextmanage-tasks to track task completionyour-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
# 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
Dashboard not starting
--dashboard flag when starting the dashboard service--port, ensure the port number is valid (1024-65535) and not in use by another applicationApprovals not working
MCP server not connecting
npm run buildPort conflicts
--port <different-number>netstat -an | find ":3000" (Windows) or lsof -i :3000 (macOS/Linux) to check what's using a port--port parameter to automatically use an available ephemeral portDashboard not updating
GPL-3.0
FAQs
MCP server for spec-driven development workflow with real-time web dashboard
The npm package @pimzino/spec-workflow-mcp receives a total of 2,155 weekly downloads. As such, @pimzino/spec-workflow-mcp popularity was classified as popular.
We found that @pimzino/spec-workflow-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.
Security News
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.