使用说明:

  • 项目简介
    • 该仓库实现了一个面向 Claude Code 等 LLM 客户端的 MCP 服务器,核心目标是以标准化的方式提供上下文信息和功能,包括:
      • 资源管理与数据访问能力(如教训库存、开发计划草案等)
      • 注册和执行工具(Tools),用于执行开发流程中的具体步骤
      • 定义与渲染 Prompt/模板(PROJECT_BRIEF.md、DEVELOPMENT_PLAN.md、CLAUDE.md 等)
      • 通过 JSON-RPC 风格与客户端通信,支持多种传输协议(如 SSE)
  • 主要功能点
    • MCP 服务端实现:提供 /sse、/mcp 等端点,基于 SDK 的 McpServer/​​​McpAgent 框架
    • 工具与模板:提供 18+ Tools,用于规划、生成、执行、验证、经验教训等
    • 计划生成与执行:从 PROJECT_BRIEF.md 生成 DEVELOPMENT_PLAN.md,具备“paint-by-numbers”细粒度子任务
    • 教训与治理:教训(Lessons)持久化(KV 存储),可从计划中注入改进点
    • 远程协作与版本控制:生成 Remediation Task、Remediation Plan,支持 Issue-to-Task 的后期工作流
    • 安全与鉴权:提供基于 API Key 的鉴权中间件(可开启/关闭),并支持速率限制
  • 安装步骤
    • 该 MCP 服务器以 Cloudflare Workers 形式部署。推荐流程:
      1. 安装 Cloudflare Wrangler(或等效工具)并进行登录配置
      2. 将代码部署到 Cloudflare Workers,按照仓库的 README 指示执行本地开发与部署
      3. 部署完成后,使用提供的 SSE Endpoint 作为客户端的 MCP 服务器地址
    • 本地调试的简要路径(如有需要)通常涉及 wrangler dev/ publish 等命令,请结合 Cloudflare 官方文档进行操作
  • 服务器配置(供 MCP 客户端使用的 JSON 形式注释说明,非代码块)
    • server_name: devplan
    • transport: sse
    • endpoint: https://devplan-mcp-server.mike-c63.workers.dev/sse
    • 备注:该字段用于 MCP 客户端在连接服务器时指定服务端入口点。实际运行模式为 Cloudflare Workers 部署的 SSE/MC P 路径;客户端不需要本地启动命令,但若需要在客户端配置中给出启动信息,可参考以下注释:
      • command: "wrangler publish"(用于将 Workers 部署上线的命令,若在本地调试则为 "wrangler dev")
      • args: ["--config", "wrangler.toml", "--env", "production"](部署时的参数,若本地开发则可能为空或包含 dev 模式标志)
    • 说明:MCP 客户端通常通过该 JSON 配置直接知道服务器名称、传输协议以及连接端点即可,与具体的部署脚本和运行环境解耦;上述 command/args 仅为客户端提供的辅助注释,实际运行以仓库提供的部署方式为准
  • 基本使用方法
    • 启动与连接:在 MCP 客户端配置中指定 server_name 为 devplan,传输为 SSE,endpoint 指向上面的 SSE URL。客户端将通过 JSON-RPC 请求向服务器获取工具、模板、计划等能力
    • 使用流程概览(简化版):
      • 通过 devplan_interview_questions 获取 Interview 问题
      • 使用 devplan_create_brief 根据回答生成 PROJECT_BRIEF.md
      • 使用 devplan_generate_plan 生成 DEVELOPMENT_PLAN.md 的初始草案
      • 通过 devplan_generate_executor 与 devplan_generate_verifier 生成执行者与验证者代理
      • 如需记录历史教训,使用 devplan_add_lesson/ devplan_list_lessons 等工具
    • 常见用例
      • 生成初始计划:devplan_create_brief → devplan_generate_plan → 使用计划执行工具
      • 将 GitHub Issue 转换为需求任务:devplan_parse_issue → devplan_issue_to_task
      • 读取并检查进度:devplan_progress_summary
  • 运行环境与依赖
    • 工作流:Cloudflare Workers(Jet/ Wrangler 等工具),前端客户端通过 SSE 与 MCP 服务交互
    • 服务端主要语言与运行环境:TypeScript/JavaScript,在 Cloudflare Workers 环境中运行
    • 客户端与服务器对接的核心要点在于 MCP 的 JSON-RPC 风格请求/响应,以及 SSE、HTTP 等传输能力
  • 关键词与定位
    • 核心用途:开发计划生成、任务分解、执行与验证、教训管理、Issue 演化为任务
    • 使用体验:为 LLM 客户端提供可执行的、逐步完成的开发流程和模板
    • 部署与扩展性:Cloudflare Workers 部署,支持多工具和模板的扩展

信息

分类

AI与计算