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 的客户端中注册使用。

与传统方案对比

工作原理

1. 客户端请求生成或导入演示项目。
2. MCP Server 返回 prepare 阶段的提示词和 JSON Schema。
3. 客户端模型根据 Schema 生成结构化 JSON。
4. ingest 工具接收 JSON，执行验证、布局、lint 和项目状态写入。
5. 导出 HTML 或 PPTX，并在需要时执行视觉 QA。
6. 按每页反馈继续修改、重新导出和检查。

仓库结构

下面按公开文件和二次开发时应保留的工程入口整理，实际新增目录应以你的本地改造为准。

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

推荐使用流程

1. 先准备 context.md 或导入现有 presentation.pptx。
2. 让 MCP 客户端读取资料并调用 ppt-generator。
3. 确认演示目的、时长、受众和演讲者信息。
4. 生成 Outline、DESIGN.md 和逐页设计规格。
5. 导出 HTML 预览或 PPTX 文件。
6. 用 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-generator

haandol/ppt-generator 更适合把 PPT 生成当成工程流程来管理的团队。它让模型只负责生成结构化内容，让本地服务负责可验证的后处理，适合需要导入、修改、导出和视觉检查都可追踪的演示文稿生产链路。