Agile Planner MCP Server

](https://mseep.ai/app/cyberlife-coder-agile-planner-mcp-server)

敏捷计划器MCP服务器（v1.7.3）-AI驱动的敏捷待办列表生成器

](https://smithery.ai/server/@cyberlife-coder/agile-planner-mcp-server)     ](https://www.npmjs.com/package/agile-planner-mcp-server) ](https://github.com/cyberlife-coder/agile-planner-mcp-server)

敏捷计划器MCP 直接在Windsurf、Cascade或Cursor中，从简单的描述中自动生成完整的敏捷积压（Epics、用户故事、MVP、迭代）或特定功能，无需任何技术技能。

最新改进（v1.7.3）： - 修复GenerateFeature的MCP模式：用户故事提取的强大改进 - 结构规则3：创建史诗/特写/用户故事档案库 - 修复Windows上的记事本问题：MCP模式下STDERR/STDOUT流的标准化 - 详细诊断日志：识别加上容易解决问题 - 项目重组：测试和临时文件的清晰组织 - 更新用户指南：帆板、Claude和Cursor的完整说明 - 看 更改日志.md 了解全部细节。 以前的改进（v1.7.1）： - MCP文档的全面重新设计：带有美人鱼图的MCP服务器架构的详细文档。 - 降低认知复杂性：关键模块（JSON解析器、MCP路由器）的主要重构。 - 增强鲁棒性：更好的错误管理和优化的E2E集成测试。 - 看 更改日志.md 了解详情。

❌ 没有敏捷计划器MCP

手动创建敏捷积压是耗时且容易出错的：

• ❌ 撰写用户故事、验收标准和任务所花费的时间
• ❌ 不同项目的格式和结构不一致
• ❌ AI编码助手没有明确的实施指南
• ❌ 没有战略框架的手动优先级排序和组织

✅ 使用敏捷计划器MCP

集中错误管理

• 函数的所有错误返回 generateBacklog et generateBacklogDirect 现在由格式化 handleBacklogError 以确保JSON的一致性和审计的鲁棒性。
• 错误示例显示以下格式： { success: false, error: { message: ... } }

Agile Planner MCP在几秒钟内生成完整、结构化的敏捷待办事项列表，并附有精确的AI引导注释：

• ✅ 完整的积压结构 有史诗、特写、用户故事和孤儿故事
• ✅ AI优化注释 逐步指导实施
• ✅ 进度跟踪 带有任务复选框和依赖关系管理
• ✅ 集中式组织 在一个专用 .agile-planner-backlog 文件夹
• ✅ 智能特征组织 自动将特征与相关史诗相关联

📑 文档

为了更好地导航，此文档已重新组织：

用户指南

• MCP集成指南 -与Claude、Cursor和Windsurf IDE集成指南
• 最佳利用率指南 -详细用户指南
• 迁移指南 -从以前版本迁移的指南

开发者文档

• 发展 -发展指南
• MCP规范 MCP协议规范
• 已知问题 -已知问题和技术债务清单
• 刷新计划 -代码重构的详细计划
• 测试重构计划 -计划对测试进行修正
• 路线图 -未来版本的路线图
• 架构MCP -完整的MCP服务器架构
• Markdown生成系统 -Markdown生成器架构
• 待办事项格式 -待办事项JSON格式规范

Helper函数

• createApiMessages（项目） -为AI生成系统/用户消息对。参数 project 可以是字符串类型 "Nom: description" 你不是对象 { name, description }.

注意TDD ：错误断言必须验证统一格式 { success: false, error: { message: ... } }. 对错误格式的任何更改都需要更新集成测试。

架构文档

• 设计 -项目的总体设计
• 积压的格式 -生成的待办事项格式
• 待办事项验证图 -验证图
• 多LLM兼容性 -与多个LLM兼容

🚦 在Windsurf/Cascade/Cursor中设置

请您的管理员或技术团队将此MCP服务器添加到您的工作区配置中：

1. 复制 .env.example 向 .env 并填写您的 OPENAI_API_KEY 或 GROQ_API_KEY.

选项1：使用本地安装

{
  "mcpServers": {
    "agile-planner": {
      "command": "node",
      "args": ["D:/path/to/agile-planner/server/index.js"],
      "env": {
        "MCP_EXECUTION": "true",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

选项2：使用NPM包

{
  "mcpServers": {
    "agile-planner": {
      "command": "npx",
      "args": ["agile-planner-mcp-server"],
      "env": {
        "MCP_EXECUTION": "true",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

🧠 运作原理

1. 描述你的项目 用简单的英语，提供尽可能多的细节。

   SaaS task management system for teams with Slack integration, 
   mobile support, and GDPR compliance.

1. 敏捷规划师MCP处理您的描述 通过稳健的验证流程：

- 🤖 利用OpenAI或Groq LLM生成待办事项列表结构 - 🧪 根据全面的JSON模式验证结构 - 🔍 通过验收标准和任务增强功能 - 📝 将故事组织成史诗和特写 - 🏗️ 使用markdown文件创建完整的目录结构

1. 接收一个完全结构化的敏捷待办事项列表 秒数：

生成文件的结构

.agile-planner-backlog/
├── epics/
│   └── [epic-slug]/
│       ├── epic.md
│       └── features/
│           └── [feature-slug]/
│               ├── feature.md
│               └── user-stories/
│                   ├── [story-1].md
│                   └── [story-2].md
├── orphan-stories/
│   ├── [story-orpheline-1].md
│   └── [story-orpheline-2].md
└── backlog.json

注： 莱斯档案 planning/mvp et planning/iterations 被删除。所有用户故事都在其epics/features树或 orphan-stories 如果它们没有附加到任何功能/Epic。文件 backlog.json 不再包含节 mvp 欧点 iterations.

所有文件都包含AI友好的说明，以指导实施。请参阅 示例 用于示例输出的文件夹。

命令

Agile Planner MCP支持以下命令：

生成完整的待办事项列表

// In Windsurf or Cascade
mcp0_generateBacklog({
  projectName: "My Project",
  projectDescription: "A detailed description of the project...",
  outputPath: "optional/custom/path"
})

// CLI
npx agile-planner-mcp-server backlog "My Project" "A detailed description of the project..."

生成特定功能

// In Windsurf or Cascade
mcp0_generateFeature({
  featureDescription: "A detailed description of the feature to generate",
  storyCount: 3,  // Optional: number of user stories to generate (min: 3)
  businessValue: "High", // Optional: business value of this feature
  iterationName: "iteration-2", // Optional: target iteration (default: 'next')
  epicName: "Optional Epic Name", // Optional: specify an epic or let the system find/create one
  outputPath: "optional/custom/path" // Optional: custom output directory
})

// CLI
npx agile-planner-mcp-server feature "A detailed description of the feature to generate"

🔄 环境变量

📜 许可证

Agile Planner MCP Server是根据带有Commons条款的MIT许可证授权的。有关完整的许可证文本，请参阅LICENSE文件。

👥 支持

如需支持，请在 或联系您的Windsurf/Cascade/Cursor管理员。

______________________________________________________________________

☕️ 支持项目

如果你觉得这个项目有用，你可以给我买杯咖啡来支持它的发展 BuyMeACoffee!

🚀 获取Windsurf

非常感谢。🙏