haandol/ppt-generator：用 MCP 拆分 PPT 生成与确定性渲染
haandol/ppt-generator：用 MCP 拆分 PPT 生成与确定性渲染
haandol/ppt-generator 是一个面向 MCP 的 PPT 生成服务器，负责提示词、JSON Schema、验证、布局、HTML/PPTX 渲染和视觉检查，把真正的 LLM 生成动作交给客户端完成。它的重点不是在服务器里保存模型密钥，而是用 prepare 和 ingest 成对工具，把“让模型写内容”和“用确定性程序处理文件”分开。
公开仓库：haandol/ppt-generator。
一分钟看效果
最小试跑先从克隆、安装或目录检查开始，确认能打开入口文件、读取 Skill 规则或启动对应服务。
git clone https://github.com/haandol/ppt-generator.git
cd ppt-generator
uv sync
codex mcp add ppt-generator -- uv --directory /path/to/ppt-generator run ppt-generator跑通后重点确认这些产物：
- 结构化项目状态
- HTML 预览
- PPTX 文件
- 导入 PPTX 后的可编辑项目
- 视觉 QA 报告
自制结构图把项目的最小路径压成一条线：先确认输入，再套用规则或模板，最后检查能交付的文件。
为什么需要这个项目
很多 AI PPT 工具把模型调用、提示词、版式修复和文件导出混在同一个脚本里，一旦某一步出错，很难知道问题出在模型输出还是后处理。这个仓库把客户端模型生成与服务器端确定性处理拆开：客户端按提示词生成 JSON，服务器只负责校验、布局、导入、导出和检查。
核心功能
- MCP Server 暴露 prepare 和 ingest 成对流程，客户端生成 JSON，服务端做验证和后处理。
- Claude Code 插件中包含 ppt-outline、ppt-design、ppt-modify、ppt-visual-qa 等工作流 Skill。
- 支持从主题生成新 PPT，也支持导入已有 PPTX 生成 HTML 预览后继续编辑。
- 不在服务器侧调用模型，不需要在服务器配置 AWS 或 Anthropic 这类模型密钥。
- 可在 Claude Code、Kiro、Codex 等支持 MCP 的客户端中注册使用。
与传统方案对比
| 维度 | 传统流程 | 自动化流程 |
|---|---|---|
| 核心目标 | 人工做 PPT 与配图 | 用本项目搭建自动化流程 |
| 适用场景 | 一次性汇报、临时排版 | 需要复用模板、生成、预览和修改的演示生产 |
| 输入格式 | 文章、想法、截图分散在不同文件 | 主题、Markdown、模板、脚本或 Agent 指令 |
| 输出形态 | 手工维护的 PPT 文件 | HTML、PPTX、PNG、视频或可继续编辑的项目产物 |
| 模板处理方式 | 靠人记住字体、配色和版式 | 把模板、规则和检查步骤放进仓库或 Skill |
| 检查方式 | 人工翻页找问题 | 命令、预览、目录检查或视觉 QA 逐步确认 |
| 适合人群 | 偶尔做演示的人 | 希望把 PPT 生产流程沉淀成工具的开发者和内容团队 |
工作原理
- 客户端请求生成或导入演示项目。
- MCP Server 返回 prepare 阶段的提示词和 JSON Schema。
- 客户端模型根据 Schema 生成结构化 JSON。
- ingest 工具接收 JSON，执行验证、布局、lint 和项目状态写入。
- 导出 HTML 或 PPTX，并在需要时执行视觉 QA。
- 按每页反馈继续修改、重新导出和检查。
仓库结构
下面按公开文件和二次开发时应保留的工程入口整理，实际新增目录应以你的本地改造为准。
ppt-generator/
├── README.md
├── pyproject.toml
├── src/ppt_generator/
├── skills/ppt-outline/
├── skills/ppt-design/
├── skills/ppt-modify/
├── skills/ppt-visual-qa/
├── docs/adr/
├── docs/harness/
├── tests/环境要求
- Python 3.13+。
- uv 包管理器。
- Claude Code 插件系统，或 Kiro、Codex、Claude Desktop 等 MCP 客户端。
- 可选：浏览器与视觉 QA 依赖，用于预览和检查页面。
安装方式
/plugin marketplace add haandol/ppt-generator
/plugin install ppt-generator@ppt-generator
git clone https://github.com/haandol/ppt-generator.git
uv sync
codex mcp add ppt-generator -- uv --directory /path/to/ppt-generator run ppt-generator推荐使用流程
- 先准备 context.md 或导入现有 presentation.pptx。
- 让 MCP 客户端读取资料并调用 ppt-generator。
- 确认演示目的、时长、受众和演讲者信息。
- 生成 Outline、DESIGN.md 和逐页设计规格。
- 导出 HTML 预览或 PPTX 文件。
- 用 ppt-visual-qa 检查页面后逐页修正。
常用命令
git clone https://github.com/haandol/ppt-generator.git
cd ppt-generator && uv sync
codex mcp add ppt-generator -- uv --directory /path/to/ppt-generator run ppt-generator
uv run ppt-generatorhaandol/ppt-generator 更适合把 PPT 生成当成工程流程来管理的团队。它让模型只负责生成结构化内容，让本地服务负责可验证的后处理，适合需要导入、修改、导出和视觉检查都可追踪的演示文稿生产链路。