ppt-mcp-server

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

Security Scan

功能与描述一致——它确实执行 python-pptx 代码并生成 PPT，但实现会直接 exec 任意 Python 代码且没有沙箱或网络/文件访问限制，存在明显滥用/数据暴露风险。

Purpose & Capability

名称/描述与代码行为一致：skill 用于执行由模型生成的 python-pptx 代码并在本地 output/ 目录生成 .pptx。requirements.txt 列出了 mcp 和 python-pptx，SKILL.md 与 server.py 中的工具（execute_pptx_code、list_templates、list_output_files）相符。没有请求与目的不相关的环境变量或外部云凭据。

Instruction Scope

SKILL.md 要求模型生成完整可运行的 Python 代码并调用 execute_pptx_code。server.py 通过 exec(processed_code, exec_globals) 直接执行该代码（在切换到 OUTPUT_DIR 的上下文中运行并将 prs.save 路径重写到 output/）。虽然对 prs.save 和 Presentation(...) 做了路径重写，但没有对导入、文件 I/O、网络请求、子进程或任意系统调用做任何限制或沙箱隔离。换言之，传入的代码可以读取/修改文件系统、联网或尝试访问本机敏感数据——而 SKILL.md 没有说明这些风险或给出安全约束。

Install Mechanism

无安装脚本（instruction-only + 代码文件包含），requirements.txt 列出依赖但没有自动下载任意可疑二进制或外部 URL。整体安装机制为低风险，但运行时行为（exec 任意代码）是主要风险点，而非安装流程本身。

Credentials

skill 未请求环境变量或外部凭据，表面上看是合适的。注意：尽管未声明凭据，execute_pptx_code 执行的任意 Python 代码仍可在运行主机上读取环境变量或访问本地凭据文件（比如 ~/.aws/credentials、~/.git-credentials 等），因此未声明凭据并不等于无法被滥用。

Persistence & Privilege

flags 显示 always:false，user-invocable:true，disable-model-invocation:false（正常）。skill 不修改其他技能配置或系统级配置。要注意：允许模型自主调用工具是平台默认行为；结合可执行任意代码这一点，会扩大攻击面。

What to consider before installing

该 skill 的功能声明与实现一致：它会接受并执行由模型生成的 Python（python-pptx）代码，然后在本地 output/ 目录写出 .pptx 文件。不过实现直接用 exec 来运行未审查的代码且没有任何沙箱、网络或权限限制——这意味着传入代码可以访问本机文件、读取环境变量、发起网络请求或运行子进程，从而可能泄露凭据或损害主机。 Before installing or running: 1) only run on an isolated machine/container (no sensitive files or credentials), 2) prefer code-review: inspect generated python before executing, or modify server.py to run untrusted code in a sandboxed subprocess with restricted filesystem and no network, timeouts, and limited builtins, 3) run with a non-privileged user and restrict template/output directories' permissions, 4) consider adding explicit runtime restrictions (drop dangerous builtins, use subprocess in a chroot/container, disable network, set CPU/memory/time limits), and 5) if you need to trust the skill, ask the author for sandboxing evidence or a provenance-backed release. If the server included strong sandboxing or explicit restrictions on what generated code may do, this assessment could move toward benign.

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