6A工作流分步执行MCP服务器

基于 Model Context Protocol (MCP) 实现的6A工作流分步执行服务，参考 @modelcontextprotocol/server-sequential-thinking 项目架构，为AI助手提供结构化的项目管理和任务执行框架。

🎯 6A工作流模式

6A工作流是一个专业的项目管理和问题解决框架，包含以下六个阶段：

| 阶段 | 英文 | 图标 | 描述 | 核心目标 | |------|------|------|------|----------| | 1 | Align | 🎯 | 对齐阶段 | 模糊需求 → 精确规范，明确项目目标和约束 | | 2 | Analyze | 🔍 | 分析阶段 | 深入分析问题域、技术栈、依赖关系和风险 | | 3 | Architect | 🏗️ | 架构阶段 | 设计系统架构、模块划分和接口定义 | | 4 | Act | ⚡ | 行动阶段 | 执行具体实现，编写代码和配置 | | 5 | Assess | 📊 | 评估阶段 | 评估实现质量、性能和符合度 | | 6 | Adjust | 🔧 | 调整阶段 | 根据评估结果进行优化和调整 |

✨ 核心特性

🎯 工作流管理

• 结构化流程: 六阶段标准化工作流，确保项目质量
• 灵活执行: 支持步骤修订、分支探索和动态调整
• 状态跟踪: 完整的执行历史和实时状态监控
• 可视化展示: 清晰的进度指示和阶段引导

🤖 AI辅助功能

• 智能任务调度: AI辅助任务分解、优先级排序和依赖管理
• 智能文件生成: 根据6A阶段自动生成标准化项目文档
• AI提示词模板: 为每个6A阶段提供专业的AI指导提示词
• 工作流状态管理: 增强的进度跟踪和健康度评估

🔧 技术特性

• 模块化架构: 高度模块化的代码结构，易于维护和扩展
• 错误处理: 统一的错误处理和异常管理机制
• 日志系统: 完整的日志记录和调试支持
• MCP兼容: 标准MCP协议，可与Claude等AI助手无缝集成

🚀 快速开始

安装依赖

npm install

启动服务器

# 开发模式（支持热重载）
npm run dev

# 生产模式
npm start

在Claude Desktop中配置

在 claude_desktop_config.json 中添加以下配置：

{
  "mcpServers": {
    "6a-workflow": {
      "command": "node",
      "args": ["/path/to/6a-workflow-mcp-server/src/index.js"]
    }
  }
}

或使用npx方式：

{
  "mcpServers": {
    "6a-workflow": {
      "command": "npx",
      "args": ["6a-workflow-mcp-server"]
    }
  }
}

🛠️ 工具说明

1. 6a_workflow - 主要工作流工具

执行6A工作流的各个阶段步骤和管理操作。

基础工作流操作

execute - 执行工作流步骤

• stage: 当前阶段 (ALIGN/ARCHITECT/ATOMIZE/APPROVE/AUTOMATE/ASSESS)
• content: 步骤内容和思考
• stepNumber: 当前步骤编号
• totalSteps: 预估总步数
• nextStepNeeded: 是否需要下一步
• workflowId: 工作流会话ID（可选）
• isRevision: 是否为修订步骤（可选）
• metadata: 附加元数据（可选）

init - 初始化项目

• project_type: 项目类型 (FRONTEND/BACKEND/FULLSTACK/MOBILE/DESKTOP/API/LIBRARY)
• project_name: 项目名称

AI辅助功能

generate_manifest - 生成项目清单

• project_type: 项目类型
• project_name: 项目名称

generate_stage_prompt - 生成阶段提示词

• stage: 6A阶段名称
• context: 上下文信息（可选）

generate_task_list - 生成AI任务清单

• project_info: 项目信息
• stage: 当前阶段

状态管理

get_workflow_status - 获取工作流状态

• workflow_id: 工作流ID（可选）

get_detailed_report - 获取详细报告

• workflow_id: 工作流ID（可选）

get_progress_metrics - 获取进度指标

• workflow_id: 工作流ID（可选）

📋 使用示例

项目初始化

// 初始化全栈项目
{
  "action": "init",
  "project_type": "FULLSTACK",
  "project_name": "用户管理系统"
}

基本工作流执行

// 1. 对齐阶段 - 明确需求
{
  "action": "execute",
  "stage": "ALIGN",
  "content": "分析用户需求：创建一个用户管理系统，包含注册、登录、权限管理功能",
  "stepNumber": 1,
  "totalSteps": 10,
  "nextStepNeeded": true
}

// 2. 架构阶段 - 系统设计
{
  "action": "execute",
  "stage": "ARCHITECT",
  "content": "设计三层架构：Controller层处理请求，Service层业务逻辑，Repository层数据访问",
  "stepNumber": 2,
  "totalSteps": 10,
  "nextStepNeeded": true
}

// 3. 原子化阶段 - 任务分解
{
  "action": "execute",
  "stage": "ATOMIZE",
  "content": "将系统分解为独立的原子任务：用户注册模块、登录验证模块、权限管理模块",
  "stepNumber": 3,
  "totalSteps": 10,
  "nextStepNeeded": true
}

AI辅助功能

// 生成阶段提示词
{
  "action": "generate_stage_prompt",
  "stage": "ALIGN",
  "context": {
    "project_type": "FULLSTACK",
    "domain": "用户管理"
  }
}

// 生成AI任务清单
{
  "action": "generate_task_list",
  "project_info": {
    "name": "用户管理系统",
    "type": "FULLSTACK"
  },
  "stage": "ARCHITECT"
}

状态管理和查询

// 获取工作流状态
{
  "action": "get_workflow_status",
  "workflow_id": "workflow_123"
}

// 获取详细报告
{
  "action": "get_detailed_report",
  "workflow_id": "workflow_123"
}

// 获取进度指标
{
  "action": "get_progress_metrics"
}

修订和分支

// 修订之前的步骤
{
  "action": "execute",
  "stage": "ARCHITECT",
  "content": "重新考虑架构：改用微服务架构提高可扩展性",
  "stepNumber": 4,
  "totalSteps": 12,
  "nextStepNeeded": true,
  "isRevision": true,
  "metadata": {
    "revision_reason": "技术栈优化"
  }
}

🎨 输出格式

服务器会输出格式化的步骤信息到stderr，包含：

┌─────────────────────────────────────────────────────────────┐
│ 📋 步骤 1/10 - 🎯 Align                                      │
├─────────────────────────────────────────────────────────────┤
│ 对齐阶段：明确需求和目标                                      │
├─────────────────────────────────────────────────────────────┤
│ 分析用户需求：创建一个用户管理系统...                         │
└─────────────────────────────────────────────────────────────┘

🔧 环境变量

• DISABLE_6A_LOGGING: 设置为 true 禁用步骤日志输出

📁 项目结构

6a-workflow-mcp-server/
├── src/
│   ├── index.js              # MCP服务器主入口
│   └── 6a-workflow-server.js # 6A工作流核心逻辑
├── package.json              # 项目配置
└── README.md                 # 项目文档

🤝 最佳实践

1. 按序执行: 建议按照6A阶段顺序执行，确保每个阶段充分完成
2. 质量优先: 在每个阶段投入足够时间，避免匆忙推进
3. 适时修订: 发现问题时及时修订，利用分支探索不同方案
4. 完整闭环: 确保执行完整的6A流程，特别是评估和调整阶段
5. 状态跟踪: 定期查询工作流状态，了解执行进度

📄 许可证

MIT License

🙏 致谢

本项目参考了 @modelcontextprotocol/server-sequential-thinking 的架构设计，感谢MCP社区的贡献。