规格工作流MCP

Name: 规格工作流MCP
Author: mamajiaa

作者：mamajiaa2 星标更新：2025-08-03

安装使用来源：spider==github.com

项目介绍

Spec Workflow MCP

English | 简体中文

一个智能的MCP服务器，用于通过需求、设计和实施文档的结构化工作流程来管理软件项目规范。

Spec Workflow MCP 是什么？

Spec Workflow MCP 帮助开发团队通过提供基于人工智能的工作流来维护高质量的项目文档，该工作流引导您创建全面的规范。

❌ 没有 Spec Workflow MCP

跨项目的文档不一致
缺少关键的需求细节
设计决策无结构
实施任务不清楚
手动跟踪文档完成情况
AI 随机跳转任务，没有结构
需求与实际代码实现之间没有联系

✅ 使用 Spec Workflow MCP

标准化的文档模板，适用于需求、设计和任务
基于最佳实践的人工智能引导文档生成
自动进度跟踪和工作流管理
智能验证文档完整性
无缝集成到 Claude 和其他兼容MCP的工具中
AI 系统地按顺序完成任务，完成一个再进行下一个
需求 → 设计 → 任务工作流确保代码符合业务需求

安装

要求

Node.js ≥ v18.0.0
npm 或 yarn
Claude Desktop 或任何兼容MCP的客户端

使用 npx 快速开始

npx spec-workflow-mcp@latest

在不同的 MCP 客户端中安装

Claude Code（推荐）

使用 Claude CLI 添加 MCP 服务器：

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

Claude Desktop

添加到您的 Claude Desktop 配置中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

Cursor

添加到您的 Cursor 配置 (~/.cursor/config.json) 中：

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

Windsurf (Codeium)

添加到您的 Windsurf 配置 (~/.codeium/windsurf/mcp_config.json) 中：

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"],
      "env": {},
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "transportType": "stdio"
    }
  }
}

VS Code（带有 MCP 扩展）

添加到您的 VS Code 设置 (settings.json) 中：

{
  "mcp.servers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

Zed

添加到您的 Zed 配置 (~/.config/zed/settings.json) 中：

{
  "assistant": {
    "version": "2",
    "mcp": {
      "servers": {
        "spec-workflow": {
          "command": "npx",
          "args": ["-y", "spec-workflow-mcp@latest"]
        }
      }
    }
  }
}

从源码安装

git clone https://github.com/kingkongshot/specs-mcp.git
cd specs-mcp
npm install
npm run build

然后添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "spec-workflow": {
      "command": "node",
      "args": ["/绝对路径/to/specs-mcp/dist/index.js"]
    }
  }
}

使用方法

安装后，MCP 服务器通过 Claude 提供以下命令：

初始化新功能

初始化 "用户认证功能" 的规范工作流

这会创建一个包含以下部分的结构化需求文档：

功能概述
用户故事
功能需求
非功能性需求
技术约束

检查进度并生成下一个文档

检查规范工作流进度

服务器分析您的当前文档，并：

显示每个部分的完成状态
识别缺失或不完整的区域
自动生成工作流中的下一个文档

完成任务

在实施计划中完成任务 #3

标记特定任务已完成，并跟踪整体进度。

跳过阶段

跳过设计阶段，进入实施

灵活性以适应您的项目需求的工作流程。

工作流程阶段

需求收集 → 2. 系统设计 → 3. 实施规划

每个阶段都有：

结构化的模板
验证规则
基于人工智能的内容生成
进度跟踪

特性

📝 智能模板：遵循最佳实践的预定义文档结构
🤖 基于人工智能的生成：根据您的项目上下文提供的智能内容建议
✅ 进度跟踪：视觉进度指示器和完成跟踪
🔄 灵活的工作流程：跳过阶段或调整过程以满足您的需求
📊 质量验证：自动检查文档完整性
🔗 MCP 集成：与 Claude 和其他 MCP 客户端无缝集成
🎯 顺序任务执行：AI 按顺序完成任务，保持焦点和上下文
🔄 需求驱动开发：从业务需求到代码实现的结构化步骤

示例工作流程

从一个功能想法开始：

"我需要构建一个用户认证系统"

初始化工作流程：

初始化 "用户认证" 的规范工作流

查看并增强生成的需求
检查进度并生成设计文档：
```
检查工作流进度
```
继续通过设计和实施阶段

跟踪任务完成情况：

完成任务 #1：设置认证数据库模式

开发

从源码构建

npm install
npm run build

在开发模式下运行

npm run dev

运行测试

npm test

使用 MCP Inspector 调试

npm run inspector

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT 许可证 - 详情见 LICENSE 文件

链接

使用 Model Context Protocol 构建 ❤️