Spec Workflow MCP

社区

用于AI辅助软件开发的规范化说明驱动开发工作流MCP服务器，配备实时Web仪表板与VSCode扩展。

分类: 开发工具第 50 / 438
Stars: ★ 4.3k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 无需凭据
许可证: GPL-3.0
最近提交: 3 个月前

65FMRS · C

该服务器提供全面的规范驱动开发功能，适合需要结构化工作流和审批机制的AI辅助开发项目。其安全特性（如本地绑定、速率限制、审计日志）适合企业环境，但缺少内置的HTTPS和用户认证，需通过反向代理补充。工具列表未在文档中明确列出，但根据描述推测具备创建、列出、执行规范等工具。

最强项 · 文档质量 16/20 最弱项 · 安全与权限 10/20

可靠性

12/20

安全与权限

10/20

维护活跃度

12/20

文档质量

16/20

安装易用性

15/20

查看各项评分依据

可靠性 12/20: README 显示项目结构清晰，有 npm 包和构建命令，但没有提供 CI 配置或测试文件来证明服务器可实际启动并完成 MCP 握手。根据静态校准规则，可靠性最高不超过 12。扣分原因是缺少可验证的执行证据。
安全与权限 10/20: README 描述了一系列安全控制（localhost 绑定、速率限制、审计日志、安全头、CORS 等），并提供 Docker 加固建议。但未在源码中验证这些实现，且用户认证/HTTPS 未实现。没有证据表明存在恶意行为，但权限和确认机制不完整，因此得分不超过 12。
维护活跃度 12/20: 仓库有 4276 颗星，但 README 提到项目作者暂时中断维护。没有提供许可证信息（主题中未显示）。虽然项目活跃度较高，但缺少维护节奏和依赖更新记录。
文档质量 16/20: README 内容详实，涵盖快速开始、客户端配置、Docker、安全、文档链接等，但缺少工具参数的具体文档（可能有 TOOLS-REFERENCE.md 但未审查）。
安装易用性 15/20: README 提供了多种客户端的配置示例（Claude、Cursor 等），步骤清晰。但缺少具体的环境准备步骤和平台兼容性说明，因此得分不超过 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

希望为AI辅助开发采用结构化规范驱动工作流的团队。
需要在开发环境中可视化监控项目进度的开发者。
需要审批流程和任务跟踪的合规性要求较高的项目。

不适合谁

无需严格规范流程的快速原型或小型项目。
希望完全在云端部署并需要用户认证和HTTPS的场景（当前需通过反向代理实现）。

所需权限

读取和写入项目目录（例如 `.spec-workflow` 文件夹）。
网络访问：Web仪表板默认监听 `127.0.0.1:5000`，仅本地访问。
创建和管理规范、任务、审批、日志等文件。

风险与副作用

数据泄露：如果仪表板暴露到网络，可能被未授权访问；默认仅绑定本地地址，但需谨慎配置反向代理和防火墙。
滥用：由于AI代理可能自动执行命令，工具可能执行不符合预期的操作，建议在受控环境中使用。
依赖风险：使用npx执行，可能受npm供应链影响，保持包版本最新。

安装接入

准备工作

运行环境：Node.js · Docker

其他可选配置项（1 个）

SPEC_WORKFLOW_HOME 可选用于在沙盒环境（$HOME只读）中重定向全局状态文件到可写位置，例如 /workspace/.spec-workflow-mcp，非密钥。

在您的AI工具（如Claude Desktop、Cursor等）的MCP配置中添加以下JSON：{"mcpServers":{"spec-workflow":{"command":"npx","args":["-y","@pimzino/spec-workflow-mcp@latest","/path/to/your/project"]}}}。
选择界面：A) 启动Web仪表板（运行 npx -y @pimzino/spec-workflow-mcp@latest --dashboard，默认端口5000）；B) 在VSCode中安装Spec Workflow MCP扩展。
确保将 /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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在MCP客户端配置好并启动后，向AI助手说“List my specs”，若能返回specs列表（或空列表）则说明服务器已连接；也可运行 npx -y @pimzino/spec-workflow-mcp@latest --dashboard 并访问 http://localhost:5000 确认仪表盘可用。

常见排障

如果仪表板无法启动，检查端口5000是否被占用，或使用 `--port` 参数指定其他端口。
如果MCP客户端无法连接，确认配置中的路径正确且具有读写权限。
在沙箱环境中，如果遇到 `$HOME` 只读错误，设置 `SPEC_WORKFLOW_HOME` 到可写目录。
对于Windows系统，如果 `claude mcp add` 命令失败，尝试使用 `cmd.exe /c` 方式。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个用户认证的spec
列出我所有的specs
执行 spec user-auth 中的任务 1.2
查看我的spec进度

使用场景

创建规范：在对话中输入“为用户认证创建规范”以生成完整的规范工作流。

监控进度：通过Web仪表板或VSCode扩展实时查看规范、任务和进度。

审批流程：在仪表板上请求审批、提供反馈并跟踪修订。

执行任务：通过“执行规范中的任务1.2”等指令运行特定任务。

支持客户端

Claude Desktop

Claude Code

Augment Code

Cline/Claude Dev

Continue IDE

Cursor

OpenCode

Windsurf

Codex

依据项目文档列出，未经本站实测。

详细介绍

Spec Workflow MCP 是一个模型上下文协议（MCP）服务器，为AI辅助软件开发提供结构化的规范驱动开发工作流。它支持按顺序创建需求、设计和任务说明，并提供实时Web仪表板及VSCode扩展，帮助开发者在开发环境中监控和管理项目进度。该服务器包含审批工作流、任务进度跟踪、实现日志（含代码统计）等功能，并支持11种语言。