🪄 魔法书 MCP（注：MCP在此处可能是一个特定名称或缩写，根据上下文可能有不同的含义，如“魔法控制协议”或特定作品中的角色/组织名等，但直接翻译为“魔法书 MCP”保持了原样，具体含义需结合上下文理解）
一个模型上下文协议服务器，它将AI提示作为咒语——即结构化、可重用的指令，适用于软件开发生命周期的各个阶段。
版本： v0.3.0\ 许可证： 麻省理工学院（MIT）
_在这里，每一个提示都是一个咒语，每一次构建都是一场仪式。_
一个可重用、带版本控制的提示工具包 + 一个轻量级（工具/框架） 模型上下文协议（MCP） 用于辅助人工智能软件开发的服务器。包括软件开发生命周期（SDLC）提示、PDCA（戴明循环）元提示、模型路由，以及一个将所有功能作为工具暴露出来的MCP服务器。
快速入门（本地）
npm -C mcp-starter i
node mcp-starter/server.js快速入门（Docker）
docker build -f Dockerfile.mcp -t spellbook-mcp:0.3.0 .
docker run --rm -it spellbook-mcp:0.3.0本地接受烟雾（PowerShell）
如果你想在Docker中本地运行快速接受测试（模拟CI环境），请使用随附的PowerShell辅助工具或npm smoketest 脚本：
# Build a local image
docker build -f Dockerfile.mcp -t spellbook-mcp:local .
# Run the smoke test with mounted logs directory (writes to ./mcp-starter/logs)
docker run --rm -it -v ${PWD}\mcp-starter\logs:/app/mcp-starter/logs spellbook-mcp:local /bin/sh -c "cd /app && npm run acceptance:quick:logging"
# Or use the included helper that wraps the same logic
npm run smoketestMCP客户端设置
将您的MCP启用客户端（Claude桌面版、Cursor、VS Code MCP桥接器）指向 .mcp.json。
仓库结构
/
├── prompts/
│ └── v0.3.0/ # SDLC + PDCA prompts for this release
│ ├── 1_requirements_planning.md
│ ├── 2_analysis_specification.md
│ ├── 3_architecture_design.md
│ ├── 4_implementation_development.md
│ ├── 5_testing_quality_assurance.md
│ ├── 6_deployment_release.md
│ ├── 7_maintenance_monitoring.md
│ └── meta/
│ ├── PDCA_cycle.md
│ ├── due_diligence_checklist.md
│ ├── retrospective_review.md
│ ├── error_learning_protocol.md
│ └── continuous_improvement_tracker.md
├── docs/
│ └── learning-log.md
├── mcp-starter/
│ ├── package.json
│ └── server.js
├── .mcp.json
├── Dockerfile.mcp
├── router.config.json
├── prompt.catalog.json
├── PROMPT_EXECUTION_MATRIX.md
├── COMMANDS.md
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
└── .github/workflows/release.yml版本控制与发布
- SemVer（语义化版本控制）主版本号.次版本号.修订号
- 为发布版本打上标签
vX.Y.Z一个GitHub Action创建了一个发布版本并附加了一个zip文件。 - 见 \
CONTRIBUTING.md\翻译为中文是：“贡献指南.md” 或 “贡献规范.md”。这个文件通常用于说明如何为某个项目或组织做出贡献，包括提交代码、报告问题、参与讨论等方面的指南 用于分支管理、PR（Pull Request）指导以及 CHANGELOG.md（变更日志文件，Markdown格式） 为了历史。
模型预算编制
见 \PROMPT_EXECUTION_MATRIX.md\ 翻译为中文是：\提示执行矩阵.md\对于代码编写，优先使用Copilot（GPT‑5 Codex）；对于深度推理，使用GPT‑4.1/5；在可接受的情况下，回退到4o/o3‑mini。
命令
见 COMMANDS.md（命令说明文件） 关于斜杠命令及其与MCP工具的映射关系。
学习与事后分析（或总结）
我们维护一个轻量级的团队学习日志，用于记录验收/持续集成（CI）失败的情况以及重要的故障排除笔记。如果验收测试或CI运行中发现了错误、不稳定测试或操作经验教训，请添加一条简短的记录 docs/learning-log.md 描述：
- 运行ID或时间戳以及受影响的分支/拉取请求（PR）
- 问题简述及根本原因（如已知）
- 所采取的调查步骤及最终的补救措施
- 关于提交（commits）、工件（artifacts）（已上传
mcp-starter/logs/**), 以及PRs（Pull Requests，即拉取请求）
将这些信息保存在仓库附近有助于加快未来的调试速度，并捕捉机构知识 prompts/v0.3.0/meta/ 目录中还包含策略工件，如 due_diligence_checklist.md 并且 retrospective_review.md 在提交学习成果时，你可以参考这个。