2025-9-28 spec-workflow-mcp

规范工作流程 MCP #

用于结构化规范驱动开发的模型上下文协议 (MCP) 服务器，具有实时仪表板和 VSCode 扩展。

☕ 支持这个项目 #

📺 展示 #

🔄 审批系统实际运行 #

了解审批系统的工作方式：创建文档、通过仪表板请求审批、提供反馈和跟踪修订。

📊 仪表板和规格管理 #

探索实时仪表板：查看规格、跟踪进度、浏览文档并监控您的开发工作流程。

✨ 主要特点 #

  • 结构化开发工作流程- 顺序规范创建（需求→设计→任务）
  • 实时 Web 仪表板- 通过实时更新监控规格、任务和进度
  • VSCode 扩展- 为 VSCode 用户集成的侧边栏仪表板
  • 审批工作流程——完成审批流程并进行修订
  • 任务进度跟踪——可视化进度条和详细状态
  • 多语言支持——提供 11 种语言版本

🌍 支持的语言 #

🇺🇸 英语 • 🇯🇵 日本语 • 🇨🇳 中文 • 🇪🇸 西班牙语 • 🇧🇷 葡萄牙语 • 🇩🇪 德语 • 🇫🇷 法语 • 🇷🇺 Русский • 🇮🇹 意大利语 • 🇰🇷 한국어 • 🇸🇦 🇨🇳

🚀 快速入门 #

步骤 1：添加到您的 AI 工具 #

添加到您的 MCP 配置（请参阅下面的客户端特定设置）：

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

使用自动启动的仪表板：

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

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/Users/guichen/Documents/paas/GUI-P/", "--AutoStartDashboard"]
    }
  }
}

第 2 步：选择界面 #

选项 A：Web 仪表板（CLI 用户必需）

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

选项 B：VSCode 扩展（推荐 VSCode 用户使用）

从 VSCode 市场安装Spec Workflow MCP 扩展。

📝 如何使用 #

只需在对话中提及 spec-workflow 即可：

  • “创建用户身份验证规范” ——创建完整的规范工作流程
  • “列出我的规格” - 显示所有规格及其状态
  • “在 spec user-auth 中执行任务 1.2” - 运行特定任务

查看更多示例 →

🔧 MCP 客户端设置 #

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/Users/guichen/Documents/paas/GUI-P/"]
    }
  }
}

📚 文档 #

📁 项目结构 #

your-project/
  .spec-workflow/
    approvals/
    archive/
    specs/
    steering/
    templates/
    user-templates/
    config.example.toml

🛠️ 开发 #

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

查看开发指南→

📄 许可证 #

GPL-3.0