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 方法