ppt-mcp-server

AI 驱动的 PPT 生成工具，通过执行 python-pptx 代码自动创建专业 PowerPoint 演示文稿

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