Pimzino/spec-workflow-mcp

Spec 驱动开发的 MCP 服务器，实时 Dashboard + VSCode 扩展，支持 Claude Code / Cursor / Windsurf 等多 AI 工具，是 claude-code-spec-workflow 的升级版本。

概述

spec-workflow-mcp 是 Pimzino 开发的 MCP 服务器，当前版本 v2.2.7。将 Spec 驱动开发工作流（需求→设计→任务→实现）通过 MCP 协议暴露给所有支持 MCP 的 AI 工具，并提供实时 Web Dashboard 和 VSCode 扩展。

核心功能

结构化开发工作流：顺序创建 Requirements → Design → Tasks，每步需用户确认
实时 Web Dashboard：监控 Spec、任务进度、实现日志，WebSocket 实时更新（端口 5000）
VSCode 扩展：侧边栏集成 Dashboard，无需切换浏览器
审批工作流：完整的审批→反馈→修订流程
实现日志：可搜索的任务实现历史，含代码统计
多语言支持：11 种语言（含中文）

安装与配置

# 启动 Dashboard（独立运行，所有项目共用一个实例）
npx -y @pimzino/spec-workflow-mcp@latest --dashboard
# 访问 http://localhost:5000

Claude Code CLI 接入：

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

通用 MCP 配置：

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

支持的 MCP 客户端

Claude Code CLI、Claude Desktop、Cursor、Windsurf、Cline、Continue、OpenCode、Codex、Augment Code

使用方式

在对话中直接描述需求：

"Create a spec for user authentication"   → 创建完整 Spec 工作流
"List my specs"                           → 查看所有 Spec 状态
"Execute task 1.2 in spec user-auth"      → 执行具体任务

项目结构

your-project/
  .spec-workflow/
    approvals/      # 审批记录
    archive/        # 归档 Spec
    specs/          # 活跃 Spec 文档
    steering/       # 项目持久上下文
    templates/      # 文档模板
    user-templates/ # 自定义模板

安全特性

默认绑定 127.0.0.1，不暴露网络
速率限制：120 请求/分钟
结构化审计日志（JSON）
安全响应头（CSP、X-Frame-Options 等）
Docker 加固：非 root 用户、只读文件系统、资源限制

Docker 部署

cd containers
docker-compose up --build
# 访问 http://localhost:5000

关联页面

superpowers — 同类 Spec 驱动开发方法论，基于 Skill 系统
agent-harness-anatomy — Agent Harness 架构解析

附录：旧版 claude-code-spec-workflow

作者已将开发重心转移到 spec-workflow-mcp（MCP 版本），本节保留旧版信息供参考。

仓库：https://github.com/Pimzino/claude-code-spec-workflow npm：@pimzino/claude-code-spec-workflow 本地路径：/Users/zhaoweiguo/6ai/opensources/claude-code-spec-workflow

旧版通过 npm 全局安装，在项目中注入完整的 .claude/ 目录结构（slash 命令、Agent、模板、Dashboard），仅支持 Claude Code。

安装与初始化

npm install -g @pimzino/claude-code-spec-workflow
cd my-project
claude-code-spec-workflow

初始化后生成：

.claude/
├── commands/     # 14 个 slash 命令 + 自动生成的任务命令
├── steering/     # product.md, tech.md, structure.md（项目上下文）
├── templates/    # 文档模板
├── specs/        # 生成的 Spec 文档
├── bugs/         # Bug 修复工作流
└── agents/       # 4 个专用 AI Agent

Spec 工作流

/spec-create user-authentication "Secure login system"
/spec-execute 1 user-authentication
/spec-status user-authentication

推荐模型分工：Claude Opus 4 跑 /spec-create，Claude Sonnet 4 跑 /spec-execute。

Bug 修复工作流

/bug-create login-timeout "Users logged out too quickly"
/bug-analyze && /bug-fix && /bug-verify

与 MCP 版本对比

维度	claude-code-spec-workflow（旧）	spec-workflow-mcp（新）
集成方式	Claude Code slash 命令	MCP 协议
兼容性	仅 Claude Code	多 AI 工具
维护状态	有限更新	主力开发
安装方式	npm 全局安装	MCP 配置
Dashboard	独立 npm 命令	内置，端口 5000

zhaoweiguo 的知识库

目录