Office-PowerPoint-MCP-Server
让 AI 编程助手通过自然语言直接生成、编辑 PowerPoint 幻灯片的 MCP 服务器
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
让 AI 编程助手通过自然语言直接生成、编辑 PowerPoint 幻灯片的 MCP 服务器
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
在职场中，PowerPoint 是展示想法的标配工具，但手工制作一份精美幻灯片往往耗时耗力——选模板、调布局、填文字，每一步都可能让人抓狂。如果你已经用上了 Claude、Cursor 这类 AI 编程助手，是否曾想过：能不能直接用自然语言「指挥」AI 帮我生成 PPT？
Office-PowerPoint-MCP-Server 正是这个问题的答案。它是一个基于 MCP（Model Context Protocol）协议的 PowerPoint 操作服务器，充当 AI 工具与 PowerPoint 文件之间的「翻译官」，让 AI 能够理解「帮我做一个蓝色主题的封面」「在第二页插入一个柱状图」这类指令，并直接输出 .pptx 文件。
2024 年 Anthropic 推出 MCP 协议后，AI 工具的插件生态迅速扩张。开发者们为 AI 编程助手接入了文件系统、数据库、浏览器、Git 等各种工具，唯独办公软件（Word、Excel、PowerPoint）长期缺席。原因很现实——Office 文件格式本质上是 ZIP 压缩的 XML 结构，复杂度高、坑多，不是一层薄薄的 API 封装就能搞定的。
开发者 GongRzhe 看中了这个空白，基于成熟的 python-pptx 库，耗时数月打造了这个 MCP 服务器。开源社区对此反应热烈，GitHub Stars 突破 1700+，并获得了 Smithery.ai 的官方收录推荐。
核心入口文件 ppt_mcp_server.py 约 300 行，负责初始化 FastMCP 实例和注册各模块工具。
图1：MCP Server 通过自然语言生成 PowerPoint 幻灯片演示
工具被组织为 10 个模块，各司其职：
| 模块 | 工具数 | 核心职责 |
|---|---|---|
presentation_tools | 4 | 演示文稿生命周期管理（新建/打开/保存/关闭） |
content_tools | ~6 | 幻灯片内容操作（文本、图片、表格） |
structural_tools | ~4 | 结构操作（幻灯片增删、布局选择） |
professional_tools | ~6 | 视觉增强（阴影、倒影、发光、柔边） |
template_tools | ~5 | 模板系统（25+ 内置模板、主题配色） |
chart_tools | ~4 | 图表生成（柱状图、折线图、饼图） |
hyperlink_tools | ~2 | 链接插入 |
connector_tools | ~2 | 连接器/箭头 |
master_tools | ~3 | 母版/占位符管理 |
transition_tools | ~2 | 幻灯片切换动画 |
总计约 32 个工具函数，覆盖了 PowerPoint 操作的方方面面。
MCP 框架：项目使用 mcp[cli]>=1.8.0，即 FastMCP 实现。FastMCP 提供了更友好的装饰器语法（@app.tool()）来定义工具，参数校验和错误处理也更规范。
核心依赖：python-pptx 是底层引擎，负责将 Python 对象映射为 Office Open XML（OOXML）结构。这是一个久经考验的库，支持 .pptx 的完整读写，包括形状、文本框、表格、图表母版等高级特性。
辅助库：Pillow 用于图片处理（亮度/对比度/饱和度调节），fonttools 用于字体管理。
值得注意的是，项目在 utils/ 目录下实现了大量辅助函数（template_utils.py 约 3000 行代码），处理自动排版、文本溢出修正、布局自适应等「脏活累活」，体现了较高的工程完整性。
方式一：Docker（推荐）
官方 Dockerfile 基于 python:3.10-alpine，安装了 gcc、musl-dev、libffi-dev，最终用 pip 安装 requirements.txt，一行命令即可运行：
docker build -t ppt-mcp-server .
docker run --rm -i ppt-mcp-server # stdin/stdout 模式
方式二：本地 Python 环境
项目提供了 setup_mcp.py 脚本，自动检测 Python 版本、创建虚拟环境、安装依赖，可通过 uv / uvx / pip 三种方式之一启动。
MCP 客户端配置：将以下配置添加到 Claude Desktop、Cursor 或 Windsurf 的 MCP 设置文件中，即可通过自然语言控制 PowerPoint。
由于是 stdio 模式（无 HTTP 端口），没有网络暴露风险，安全性较好。
能做：批量生成标准格式报告的 PPT 版本、自动将数据图表转换为幻灯片、制作带公司品牌模板的培训材料、为每一张幻灯片应用统一配色和字体、将多张产品图片排版为展示页。
有限制：不支持宏（VBA）、不支持 PowerPoint 原生动画序列、不支持复杂母版嵌套。
Office 文档操作是 AI Agent 落地的「最后一公里」难题之一。相比已经成熟的 PDF 操作，PowerPoint 的开源自动化方案长期稀缺。Office-PowerPoint-MCP-Server 的出现填补了这个空白，以 MCP 协议的标准接口交付，任何兼容 MCP 的 AI 工具（不只是 Claude）都可以即插即用。
随着 AI Agent 在企业场景的渗透，批量、自动化、可复现的文档生成需求会持续增长。这个项目虽然只是一个起点，但展示了「AI 写 PPT」这一工作流的可行路径。