Devplan MCP Server

🚀 DevPlan MCP Server

アイデアを実行可能な開発計画に変える — ClaudeCode-DevPlanBuilder の方法論をClaude Codeに導入するMCPサーバーです。

問題点：AIコーディングアシスタントは、コンテキストを失ったり、手順をスキップしたり、セッション間で一貫性のないコードを生成したりすることがよくあります。

解決策：DevPlanは、組み込みの検証、学習した教訓、および問題対応ワークフローを備えた、詳細なHaiku実行可能な開発計画を作成します。

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

🚀 クイックスタート

あなた: "dotfilesを管理するCLIツールを開発するのにdevplanを使ってください"

これだけです。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: インタビュー質問（1つずつ）
        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の問題を構造化された対応タスクに変換します — バグ修正やリリース後のメンテナンスに最適です。

flowchart LR
    A["gh issue view 123 --json ..."] --> B[devplan_parse_issue]
    B --> C{分析}
    C --> D[タイプ: バグ/機能]
    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 Server"]
        SSE[SSEエンドポイント]
        Tools[18個のMCPツール]
        Gen[計画生成器]
    end

    subgraph Storage["Cloudflare"]
        KV[(教訓KV)]
        DO[Durable Objects]
    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 Server - 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

🔧 技術詳細

DevPlan MCP Serverは、Claude Codeと連携して、開発計画の作成と実行を支援するMCPサーバーです。サーバーはCloudflare Workers上で動作し、SSE（Server-Sent Events）を使用してClaude Codeと通信します。また、CloudflareのKVストレージとDurable Objectsを使用して、教訓やプロジェクトデータを保存します。

📄 ライセンス

MIT

Claude Code向けに構築
Model Context Protocol • Cloudflare Workers • DevPlanBuilder Methodology