使用说明:
- 项目简介
- 该仓库实现了一个面向 Claude Code 等 LLM 客户端的 MCP 服务器,核心目标是以标准化的方式提供上下文信息和功能,包括:
- 资源管理与数据访问能力(如教训库存、开发计划草案等)
- 注册和执行工具(Tools),用于执行开发流程中的具体步骤
- 定义与渲染 Prompt/模板(PROJECT_BRIEF.md、DEVELOPMENT_PLAN.md、CLAUDE.md 等)
- 通过 JSON-RPC 风格与客户端通信,支持多种传输协议(如 SSE)
- 该仓库实现了一个面向 Claude Code 等 LLM 客户端的 MCP 服务器,核心目标是以标准化的方式提供上下文信息和功能,包括:
- 主要功能点
- 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 形式部署。推荐流程:
- 安装 Cloudflare Wrangler(或等效工具)并进行登录配置
- 将代码部署到 Cloudflare Workers,按照仓库的 README 指示执行本地开发与部署
- 部署完成后,使用提供的 SSE Endpoint 作为客户端的 MCP 服务器地址
- 本地调试的简要路径(如有需要)通常涉及 wrangler dev/ publish 等命令,请结合 Cloudflare 官方文档进行操作
- 该 MCP 服务器以 Cloudflare Workers 形式部署。推荐流程:
- 服务器配置(供 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与计算