DevPlan MCP服务器
   
将想法转化为可执行的开发计划 --MCP服务器,它带来 ClaudeCode开发计划生成器 Claude Code的方法论。
问题:AI编码助手经常丢失上下文、跳过步骤或在会话中产生不一致的代码。 解决方案:DevPlan创建了详细的、代理可执行的开发计划,其中包含内置验证、经验教训和内联git工作流。
主要特点
| 特性 | 描述 |
|---|---|
| 代理可执行计划 | 计划如此详细,以至于任何LLM编码代理都可以机械地执行它们 |
| 内置验证 | 在执行开始之前验证计划是否完整 |
| 实时进度跟踪 | 与Claude Code的任务工具集成,实现实时可见性 |
| 经验教训 | 从验证中捕获问题并将其注入未来的计划中 |
| 问题补救 | 将GitHub问题直接转化为补救任务 |
| 执行器和验证代理 | 自动生成内置任务跟踪的专用代理 |
安装
claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user或添加到 ~/.claude.json 在...之下 mcpServers 按键:
{
"mcpServers": {
"devplan": {
"type": "sse",
"url": "https://mcp.devplanmcp.store/sse"
}
}
}更新现有安装
如果您已经安装了DevPlan,请从两个作用域中删除并重新添加:
claude mcp remove devplan --scope project; claude mcp remove devplan --scope user; claude mcp add devplan --transport sse https://mcp.devplanmcp.store/sse --scope user快速开始
You: "Use devplan_start to help me build a CLI tool for managing dotfiles"就是这样。DevPlan将指导克劳德完成整个过程。
DevPlan工作流程
DevPlan使用 脚手架→ 增强→ 验证 工作流,确保每个计划在实施开始前都是代理可执行的。
flowchart LR
subgraph Planning["📋 Planning"]
A[Interview] --> B[Brief]
B --> C[Generate Scaffold]
end
subgraph Enhancement["✨ Enhancement"]
C --> D[Enhance with Code]
D --> E{Validate}
E -->|Fail| D
E -->|Pass| F[Ready]
end
subgraph Execution["⚡ Execution"]
F --> G[Agent Executes]
G --> H[Agent Verifies]
end
subgraph Learning["🧠 Learning"]
H -->|issues| I[Capture Lessons]
I -->|improve| C
end
style E fill:#fff3e0,stroke:#f57c00
style F fill:#c8e6c9,stroke:#2e7d32
style I fill:#e3f2fd,stroke:#1565c0运作原理
- 面试 → DevPlan通过提问来了解您的项目
- 简报 → 根据需求创建结构化的PROJECT_BRIEF.md
- 生成脚手架 →
devplan_generate_plan创建基础阶段+功能列表 - 用代码增强 → 您的AI代理结构具有阶段特征,并填写完整的可复制粘贴代码
- 验证 →
devplan_validate_plan检查计划是否可由代理执行 - 执行 → 执行器代理使用内联git命令实现每个子任务
- 验证 → 验证器代理试图破坏实现
- 学习 → 问题成为未来项目的教训
验证确保质量
验证步骤检查计划是否真正可执行:
- ✅ 完整的代码块(不是伪代码或占位符)
- ✅ 代码块中包含的所有导入
- ✅ 无“添加到现有”说明
- ✅ 无交叉子任务引用
- ✅ 具有预期输出的验证命令
# Example validation output
{
"valid": true,
"errors": [],
"warnings": [],
"stats": {
"subtasks": 5,
"codeBlocksChecked": 8,
"issuesFound": 0
}
}任务工具的实时进度
生成的执行器和验证器代理与Claude Code的任务工具集成,以实现实时进度可见性:
- 执行人代理人 为每个子任务创建任务,随着工作的进展显示实时微调器
- 验证器代理 为每个验证阶段(烟雾测试、功能验证、边缘案例等)创建任务
- 无需滚动即可看到进展——你总是知道克劳德在做什么
# Example: Executor tracks subtasks
TaskCreate({ subject: "1.2.3: Implement auth middleware", activeForm: "Implementing auth middleware" })
TaskUpdate({ taskId: "...", status: "in_progress" })
# ... work happens ...
TaskUpdate({ taskId: "...", status: "completed" })任务工具(实时可见性)和DEVELOPMENT_PLAN.md(持久记录)都会更新,让您两全其美。
使用示例
新项目
"Use devplan_start to help me build [your idea]"修复GitHub问题
# Get issue JSON
gh issue view 123 --json number,title,body,labels,comments,url > issue.json
# Then tell Claude:
"Use devplan_issue_to_task with this issue to create a remediation plan"检查进度
"Use devplan_progress_summary to show me where we are"多模型支持
DevPlan为多种AI编码工具和模型生成计划和代理文件。使用 target 参数为您的首选工具生成输出。
支持的目标
| 目标 | 工具 | 代理文件 | 最适合 |
|---|---|---|---|
claude | 克劳德代码 | CLAUDE.md | 克劳德代码IDE(默认) |
cursor | 光标IDE | .cursorrules | 光标AI编辑器 |
aider | 助手CLI | .aider.conf.yml | 基于终端的AI配对编程 |
cline | VS代码库 | .cline/instructions.md | VS代码扩展 |
windsurf | Windsurf IDE | .windsurf/rules.md Codium 的 AI IDE | |
generic | 任何型号 | AGENTS.md +文件 | 与模型无关的markdown格式 |
使用目标
生成计划或代理文件时,指定目标工具:
为Cursor生成计划:
"Use devplan_generate_plan to create a plan, then I'll customize it for Cursor. Set target to 'cursor' for .cursorrules format"为助手生成执行器:
"Use devplan_generate_executor with target='aider' to create an Aider-compatible executor agent"生成通用代理文件:
"Use devplan_generate_claude_md with target='generic' to create model-agnostic AGENTS.md files"目标如何运作
每个目标都有一个专用 适配器 将DevPlan方法论转换为适当的格式:
- 克劳德 -生成
CLAUDE.md其中包含执行者/验证者代理.claude/agents/ - 光标 -生成
.cursorrules所有指导都在一个文件中(Cursor不支持单独的代理) - 教唆者 -生成
.aider.conf.yml使用架构师模式指令 - 克莱恩 -生成
.cline/instructions.md执行者/验证者分离 - 帆板运动 -生成
.windsurf/rules.md采用级联优化格式 - 通用的 -生成
AGENTS.md,EXECUTOR.md,以及VERIFIER.md适用于任何工具
示例
为Cursor启动一个新项目:
"Use devplan_start to help me build a CLI tool, then generate the plan with target='cursor' for Cursor IDE"为特定目标添加执行者:
"I have a development plan. Use devplan_generate_executor with target='aider' to create the executor agent for Aider"比较适配器功能: 看 docs/ADAPTERS.md 详细比较每个目标的能力和局限性。
工具
规划
| 工具 | 目的 |
|---|---|
devplan_start | 主要切入点-指导Claude完成方法论 |
devplan_interview_questions | 获取问题以收集项目需求 |
devplan_create_brief | 生成项目_BRIEF.md |
devplan_parse_brief | 将现有简报解析为结构化数据 |
devplan_list_templates | 列出项目模板(cli、web_app、api、库) |
生成
| 工具 | 目的 |
|---|---|
devplan_generate_plan | 生成带有验证说明的DEVELOPMENT_PLAN.md脚手架 |
devplan_generate_claude_md | 生成CLAUDE.md脚手架 |
devplan_generate_executor | 使用任务工具集成生成执行器代理 |
devplan_generate_verifier | 使用任务工具集成生成验证器代理 |
验证与执行
| 工具 | 目的 |
|---|---|
devplan_validate_plan | 验证计划结构和代理的可执行性 |
devplan_get_subtask | 按ID获取特定子任务的详细信息 |
devplan_update_progress | 用注释标记已完成的子任务 |
devplan_progress_summary | 获取完成统计数据和下一步行动 |
经验教训
从验证中捕捉问题并将其纳入未来计划的反馈回路。
| 工具 | 目的 |
|---|---|
devplan_add_lesson | 从验证者的发现中吸取教训 |
devplan_list_lessons | 按严重程度列出累积的教训 |
devplan_archive_lesson | 存档旧课程而不删除它们 |
devplan_delete_lesson | 删除过时或不正确的课程 |
devplan_extract_lessons_from_report | 从验证报告中自动提取经验教训 |
问题补救
将GitHub问题转化为结构化的修复任务——非常适合bug修复和发布后维护。
| 工具 | 目的 |
|---|---|
devplan_parse_issue | 分析GitHub问题以提取需求 |
devplan_issue_to_task | 生成包含问题子任务的补救任务 |
分析
| 工具 | 目的 |
|---|---|
devplan_usage_stats | 查看用户使用情况分布 |
为什么选择DevPlan?
| 无DevPlan | 有DevPlan |
|---|---|
| 会话之间的上下文丢失 | 计划保留完整的上下文 |
| 代码质量不一致 | 执行器代理遵循精确的规范 |
| 重复同样的错误 | 经验教训系统可防止再次发生 |
| 无验证步骤 | 验证器代理主动尝试破解代码 |
| 生产中发现的错误 | 发布前发现的问题 |
| 计划需要解释 | 已验证的计划已准备好复制粘贴 |
仪表板和分析
DevPlan包括一个公共仪表板,用于查看汇总使用统计数据:
仪表板URL: devplanmcp.store/仪表板
仪表板显示:
- 总结卡:会议总数、工具调用总数、到达的国家
- 折线图:过去30天的会议和工具调用
- 国家表:按会议次数排列的前10个国家
隐私
所有分析都是保护隐私的:
- 无IP存储:只有Cloudflare衍生的国家/地区代码
- 无用户标识:会话是匿名的
- 自动过期:每日统计数据通过KV TTL在90天后过期
发展
npm install
npm run dev # Local development
npm run deploy # Deploy to Cloudflare Workers贡献
欢迎投稿!请查看 ClaudeCode开发计划生成器 repo以获取方法细节。
许可证
麻省理工学院
______________________________________________________________________
Built for Claude Code
Model Context Protocol • Cloudflare Workers • DevPlanBuilder Methodology
