Devplan MCP Server

🚀 DevPlan MCP 服务器

将想法转化为可执行的开发计划 —— 这是一个 MCP 服务器，它将 ClaudeCode-DevPlanBuilder 方法引入了 Claude Code。

AI 编码助手在不同会话中常常会丢失上下文、跳过步骤或生成不一致的代码。而 DevPlan 可以创建详细的、可由 Haiku 执行的开发计划，内置验证、经验教训总结和问题修复工作流程，有效解决上述问题。

🚀 快速开始

你："使用 devplan 帮我构建一个用于管理点文件的 CLI 工具"

就这么简单。DevPlan 会引导 Claude 完成整个过程：

sequenceDiagram
    participant You
    participant Claude as Claude Code
    participant MCP as DevPlan MCP
    participant KV as Lessons KV

    rect rgb(240, 248, 255)
        Note over You,MCP: 📋 规划阶段
        You->>Claude: "帮我构建一个 CLI 工具"
        Claude->>MCP: devplan_start()
        MCP-->>Claude: 内联方法指导
        Claude->>You: 访谈问题（一次一个）
        You-->>Claude: 回答
        Claude->>MCP: devplan_create_brief()
        MCP-->>Claude: PROJECT_BRIEF.md
        Claude->>MCP: devplan_generate_plan()
        MCP->>KV: 获取经验教训
        KV-->>MCP: 过往经验教训
        MCP-->>Claude: DEVELOPMENT_PLAN.md + 经验教训
        Claude->>MCP: devplan_generate_executor()
        Claude->>MCP: devplan_generate_verifier()
    end

    rect rgb(255, 248, 240)
        Note over You,Claude: ⚡ 执行阶段
        loop 每个子任务
            Claude->>Claude: 使用 Haiku 代理执行
            Claude->>Claude: 使用 Sonnet 代理验证
            Claude->>MCP: devplan_update_progress()
        end
    end

    rect rgb(240, 255, 240)
        Note over You,KV: 🧠 学习阶段
        Claude->>MCP: devplan_extract_lessons_from_report()
        Claude->>MCP: devplan_add_lesson()
        MCP->>KV: 存储以备未来项目使用
    end

    Claude-->>You: ✅ 项目完成！

✨ 主要特性

📦 安装指南

claude mcp add devplan --transport sse https://devplan-mcp-server.mike-c63.workers.dev/sse

或者添加到 ~/.claude/mcp.json：

{
  "mcpServers": {
    "devplan": {
      "type": "sse",
      "url": "https://devplan-mcp-server.mike-c63.workers.dev/sse"
    }
  }
}

💻 使用示例

基础用法

新项目

"使用 devplan 帮我构建 [你的想法]"

修复 GitHub 问题

# 获取问题 JSON
gh issue view 123 --json number,title,body,labels,comments,url > issue.json

# 然后告诉 Claude
"使用 devplan_issue_to_task 和这个问题创建一个修复计划"

检查进度

"使用 devplan_progress_summary 告诉我当前进度"

📚 详细文档

工具

规划工具

生成工具

执行工具

经验教训总结工具

反馈循环，捕获验证过程中的问题，并将其融入未来的计划中。

问题修复工具

将 GitHub 问题转化为结构化的修复任务 —— 非常适合 bug 修复和发布后维护。

flowchart LR
    A["gh issue view 123 --json ..."] --> B[devplan_parse_issue]
    B --> C{分析}
    C --> D[类型: bug/功能]
    C --> E[严重程度: 🔴🟠🟡🔵]
    C --> F[组件]
    B --> G[devplan_issue_to_task]
    G --> H[DEVELOPMENT_PLAN.md]

    style A fill:#f5f5f5,stroke:#333
    style H fill:#c8e6c9,stroke:#2e7d32

架构

graph TB
    subgraph Client["Claude Code"]
        CC[Claude Code CLI]
    end

    subgraph MCP["DevPlan MCP 服务器"]
        SSE[SSE 端点]
        Tools[18 个 MCP 工具]
        Gen[计划生成器]
    end

    subgraph Storage["Cloudflare"]
        KV[(经验教训 KV)]
        DO[持久对象]
    end

    subgraph Methodology["参考"]
        GH[GitHub: ClaudeCode-DevPlanBuilder]
    end

    CC <-->|SSE| SSE
    SSE --> Tools
    Tools --> Gen
    Gen --> KV
    Tools --> DO
    Gen -.->|示例| GH

    style CC fill:#e3f2fd,stroke:#1565c0
    style KV fill:#fff3e0,stroke:#ef6c00
    style GH fill:#f3e5f5,stroke:#7b1fa2

近期更新

timeline
    title DevPlan MCP 服务器 - 2025 年 12 月

    section 第 3 周
        内容漂移检测 : 检测过时的内联指导
        内联方法 : 无需外部获取
        问题修复 : GitHub 问题 → 任务

    section 第 2 周
        错误恢复 : 执行器代理指导
        经验教训增强 : 主动反馈循环
        验证器代理 : 自动生成验证器

    section 第 1 周
        技术冲突检测 : 对不良组合发出警告
        任务完成部分 : 压缩合并工作流

为什么选择 DevPlan？

graph LR
    subgraph Without["❌ 没有 DevPlan"]
        A1[模糊的提示] --> A2[不一致的代码]
        A2 --> A3[丢失上下文]
        A3 --> A4[重复错误]
    end

    subgraph With["✅ 有 DevPlan"]
        B1[结构化访谈] --> B2[详细计划]
        B2 --> B3[Haiku 执行]
        B3 --> B4[Sonnet 验证]
        B4 --> B5[捕获经验教训]
        B5 -.-> B2
    end

    style A4 fill:#ffcdd2,stroke:#c62828
    style B5 fill:#c8e6c9,stroke:#2e7d32

🔧 技术细节

规划流程

flowchart LR
    subgraph Planning["📋 规划"]
        A[访谈] --> B[简报]
        B --> C[计划]
    end

    subgraph Execution["⚡ 执行"]
        C --> D[执行]
        D --> E[验证]
    end

    subgraph Learning["🧠 学习"]
        E -->|问题| F[经验教训]
        F -->|改进| C
    end

    subgraph Remediation["🔧 修复"]
        G[GitHub 问题] --> H[解析]
        H --> I[任务]
        I --> D
    end

    style A fill:#e1f5fe,stroke:#0288d1
    style F fill:#fff3e0,stroke:#f57c00
    style G fill:#fce4ec,stroke:#c2185b

📄 许可证

本项目采用 MIT 许可证。

为 Claude Code 构建
模型上下文协议 • Cloudflare Workers • DevPlanBuilder 方法