适合谁
- 希望为AI辅助开发采用结构化规范驱动工作流的团队。
- 需要在开发环境中可视化监控项目进度的开发者。
- 需要审批流程和任务跟踪的合规性要求较高的项目。
S
65FMRS · C
该服务器提供全面的规范驱动开发功能，适合需要结构化工作流和审批机制的AI辅助开发项目。其安全特性（如本地绑定、速率限制、审计日志）适合企业环境，但缺少内置的HTTPS和用户认证，需通过反向代理补充。工具列表未在文档中明确列出，但根据描述推测具备创建、列出、执行规范等工具。
Spec Workflow MCP 是一个模型上下文协议（MCP）服务器，为AI辅助软件开发提供结构化的规范驱动开发工作流。它支持按顺序创建需求、设计和任务说明，并提供实时Web仪表板及VSCode扩展，帮助开发者在开发环境中监控和管理项目进度。该服务器包含审批工作流、任务进度跟踪、实现日志（含代码统计）等功能，并支持11种语言。
工具能力
暂未整理工具清单。
安装接入
- 在您的AI工具（如Claude Desktop、Cursor等）的MCP配置中添加以下JSON：{"mcpServers":{"spec-workflow":{"command":"npx","args":["-y","@pimzino/spec-workflow-mcp@latest","/path/to/your/project"]}}}。2. 选择界面：A) 启动Web仪表板（运行
npx -y @pimzino/spec-workflow-mcp@latest --dashboard，默认端口5000）；B) 在VSCode中安装Spec Workflow MCP扩展。3. 确保将/path/to/your/project替换为您的实际项目路径。对于Claude Code CLI，使用claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project。在沙箱环境中，设置SPEC_WORKFLOW_HOME环境变量以重定向全局状态文件。
claude_desktop_config.json
{
"mcpServers": {
"spec-workflow": {
"command": "npx",
"args": [
"-y",
"@pimzino/spec-workflow-mcp@latest",
"/path/to/your/project"
]
}
}
}
选型与风险
不适合谁
- 无需严格规范流程的快速原型或小型项目。
- 希望完全在云端部署并需要用户认证和HTTPS的场景（当前需通过反向代理实现）。
所需权限
- 读取和写入项目目录（例如 `.spec-workflow` 文件夹）。
- 网络访问：Web仪表板默认监听 `127.0.0.1:5000`，仅本地访问。
- 创建和管理规范、任务、审批、日志等文件。
风险与副作用
- 数据泄露：如果仪表板暴露到网络，可能被未授权访问；默认仅绑定本地地址，但需谨慎配置反向代理和防火墙。
- 滥用：由于AI代理可能自动执行命令，工具可能执行不符合预期的操作，建议在受控环境中使用。
- 依赖风险：使用npx执行，可能受npm供应链影响，保持包版本最新。
常见排障
- 如果仪表板无法启动，检查端口5000是否被占用，或使用 `--port` 参数指定其他端口。
- 如果MCP客户端无法连接，确认配置中的路径正确且具有读写权限。
- 在沙箱环境中，如果遇到 `$HOME` 只读错误，设置 `SPEC_WORKFLOW_HOME` 到可写目录。
- 对于Windows系统，如果 `claude mcp add` 命令失败，尝试使用 `cmd.exe /c` 方式。
使用场景
创建规范：在对话中输入“为用户认证创建规范”以生成完整的规范工作流。
监控进度：通过Web仪表板或VSCode扩展实时查看规范、任务和进度。
审批流程：在仪表板上请求审批、提供反馈并跟踪修订。
执行任务：通过“执行规范中的任务1.2”等指令运行特定任务。
支持客户端
Claude Desktop完整支持
Claude Code CLI完整支持
Augment Code完整支持
Cline/Claude Dev完整支持
Continue IDE完整支持
Cursor完整支持
OpenCode完整支持
Windsurf完整支持
Codex完整支持