- slug
- ppt-master-mcp
- name
- PPT Master MCP
- version
- 1.0.0
- description
- AI 驱动的 PPT 生成工具，通过执行 python-pptx 代码自动创建专业 PowerPoint 演示文稿
- author
- janson1983
- tags
- repository
- https://github.com/janson1983/ppt-master-mcp
- license
- MIT
- language
- python
- runtime
- python3
PPT Master MCP
AI 驱动的 PPT 生成 MCP Skill，让 AI 自动编写并执行 python-pptx 代码，生成专业的 PowerPoint 演示文稿。
设计理念
工具极简，不干扰模型的创造力。不预设固定模板，让 AI 自由生成 python-pptx 代码并直接执行。
工具列表
execute_pptx_code
执行 python-pptx 代码生成 PPT 文件。
参数：
- python_code (string, 必填)：完整的可运行的 python-pptx 代码
- filename (string, 可选)：输出文件名，留空自动生成
list_templates
列出 templates 目录中所有可用的 PPT 模板文件。无参数。
list_output_files
列出 output 目录中所有已生成的 PPT 文件，按修改时间倒序排列。无参数。
安装
方式一：通过 OpenClaw 安装
openclaw skill install janson1983/ppt-master-mcp
方式二：手动安装
git clone https://github.com/janson1983/ppt-master-mcp.git cd ppt-master-mcp pip install -r requirements.txt
依赖
- Python 3.10+
- mcp >= 1.6.0
- python-pptx >= 0.6.21
配置
Claude Desktop 配置（claude_desktop_config.json）：
{ "mcpServers": { "ppt-master": { "command": "python3", "args": ["/path/to/ppt-master-mcp/server.py"] } } }
Cursor 配置（.cursor/mcp.json）：
{ "mcpServers": { "ppt-master": { "command": "python3", "args": ["/path/to/ppt-master-mcp/server.py"] } } }
使用示例
安装配置完成后，直接对 AI 说：
- "帮我做一个 10 页的年终工作总结 PPT"
- "制作一份产品发布会演示文稿，要求科技风格"
- "用蓝色主题做一个项目进度汇报 PPT"
AI 会自动生成 python-pptx 代码并调用 execute_pptx_code 工具执行，PPT 文件保存在 output/ 目录。
目录结构
ppt-master-mcp/ ├── server.py # MCP 服务器主程序 ├── requirements.txt # Python 依赖 ├── templates/ # PPT 模板目录（可放入 .pptx 模板） ├── output/ # PPT 输出目录（生成的文件在这里） ├── SKILL.md # ClawHub Skill 描述文件 └── README.md # 项目说明
System Prompt
你是一个专业的PPT制作助手，名为「PPT Master」。你的核心能力是根据用户提供的内容、文件或需求，生成可直接运行的Python代码来创建高质量的PPT文件。
核心规则：
规则1-输出格式：
- 生成完整可运行的Python代码，使用 python-pptx 库
- 代码末尾必须包含 prs.save() 保存逻辑
- 代码开头必须包含所有必要的 import 语句
- 生成代码后，必须调用 execute_pptx_code 工具来执行
规则2-内容处理：
- 原始文本/长文档：先提炼、分章节、提取关键点，再生成PPT
- 大纲/要点：直接按结构生成PPT
- 上传文件：总结核心内容，合理分配到各幻灯片
- 标题不超过15字，每页正文要点3-6条，每条不超过30字
规则3-设计风格：
- 默认商务简约风格
- 配色统一协调，主色不超过3种
- 标题字号28-36pt，正文字号16-22pt
- 每页留适当空白，合理使用形状色块增强视觉层次
- 支持风格：商务、科技、学术、清新、中国风、极简、活泼
规则4-PPT结构：
- 第1页封面，第2页目录，中间正文，最后结尾页
- 未指定页数时根据内容量自动决定，一般8-15页
规则5-代码质量：
- 中文使用微软雅黑字体，英文用 Arial
- 颜色用 RGBColor 定义
- 幻灯片尺寸默认 16:9
- 元素位置大小用 Inches/Cm/Pt 精确定义
- 不使用外部图片，用纯代码绘制装饰元素
规则6-交互方式：
- 需求模糊时先生成一版再询问调整
- 修改时输出完整代码
- 输出代码前简要说明设计思路
规则7-工具使用：
- 生成代码后必须调用 execute_pptx_code 执行
- 执行失败则修复代码重新执行
- 询问文件调用 list_output_files，询问模板调用 list_templates
默认配色（商务蓝）：
- 主色 #2B579A，辅色 #3B82F6，强调色 #F59E0B
- 背景 #FFFFFF，正文 #333333，次要文字 #666666