PptMcp - 用于 Microsoft PowerPoint 的 MCP 服务器

使用 AI 自动化 PowerPoint — 一个模型上下文协议 (MCP) 服务器，通过对话式 AI 实现全面的 PowerPoint 自动化。

PptMcp 使 GitHub Copilot、Claude 和 ChatGPT 等 AI 助手能够通过自然语言命令自动化 Microsoft PowerPoint。它端到端地覆盖真实的演示文稿工作：创建幻灯片、编辑文本、放置形状和图像、构建图表和表格、应用主题、运行 VBA、导出为 PDF 或视频，并通过原生 COM API 安全地管理实时 PowerPoint 窗口。

来源与致谢： 本项目基于 Stefan Broenner (sbroenne) 在 mcp-server-excel 中创建的原始 MCP 自动化基础，并在此扩展为完整的 PowerPoint 专用工具链。

发布与包： GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

对于从源代码进行多阶段构建/验证/修复的工作流，仓库还包含位于 src\PptMcp.Agent 下的官方编排客户端。

🛡️ 100% 安全 — 使用 PowerPoint 的原生 COM API — 零文件损坏风险。使用 PowerPoint 官方 COM API，确保完全安全和兼容。

💡 交互式开发 — 在 PowerPoint 中即时查看结果。添加幻灯片、创建图表、格式化文本并迭代。PowerPoint 成为你的 AI 驱动工作区。

技术要求：

• ⚠️ 仅限 Windows — COM 互操作是 Windows 特有的

• ⚠️ 需要 PowerPoint — 必须安装 Microsoft PowerPoint 2016 或更高版本

• ⚠️ 桌面环境 — 控制实际的 PowerPoint 进程（不用于服务器端处理）

🎯 你能做什么

33 个专用工具，共 223 个操作：

• 📁 文件 (1 个工具，6 个操作) — 打开、关闭、创建、保存、列出、验证演示文稿

• 📄 幻灯片 (1 个工具，15 个操作) — 创建、复制、移动、删除、应用版式、隐藏/取消隐藏、缩略图、克隆并替换

• 🔷 形状 (1 个工具，35 个操作) — 添加、移动、调整大小、填充、渐变、线条、阴影、发光、反射、不透明度、3D、旋转、Z 顺序、分组、连接符、合并、翻转、缩放

• ✏️ 文本 (1 个工具，18 个操作) — 获取/设置文本、查找、替换、格式化、间距、项目符号、大小写、符号、替代文本审计

• 📋 幻灯片表格 (1 个工具，13 个操作) — 创建、读取/写入单元格和行、添加/删除行和列、合并、格式化、边框

• 📊 图表 (1 个工具，10 个操作) — 创建、设置数据、标题、类型、图例、轴标题、数据表

• 🖼️ 图像 (1 个工具，4 个操作) — 插入、裁剪、亮度/对比度、透明色

• 🎥 媒体 (1 个工具，4 个操作) — 插入音频/视频、媒体信息、播放设置

• 🧩 SmartArt (1 个工具，6 个操作) — 图示信息、添加/删除节点、布局、样式、级别更改

• 🎨 设计/主题 (1 个工具，19 个操作) — 主题、配色方案、字体、原型、调色板、布局网格、样式配置文件

• 🖌️ 幻灯片背景 (1 个工具，5 个操作) — 获取、纯色、渐变、图像、重置为母版

• 🎭 母版和版式 (1 个工具，5 个操作) — 列出母版和版式、编辑母版形状、删除未使用的

• 📌 占位符 (1 个工具，3 个操作) — 列出占位符、设置文本、设置图像

• 📃 页眉和页脚 (1 个工具，2 个操作) — 获取/设置页脚文本、幻灯片编号、日期

• 📐 页面设置 (1 个工具，3 个操作) — 幻灯片大小、方向、第一张幻灯片编号

• ↔️ 形状对齐 (1 个工具，2 个操作) — 在幻灯片上对齐和分布形状

• 🎬 动画 (1 个工具，6 个操作) — 列出、添加、删除、清除、计时、重新排序

• 🔀 切换 (1 个工具，4 个操作) — 获取、设置、删除、复制到所有幻灯片

• 📺 幻灯片放映 (1 个工具，5 个操作) — 开始、停止、导航、状态、配置

• 🎞️ 自定义放映 (1 个工具，3 个操作) — 创建、列出、删除自定义幻灯片放映

• 📂 节 (1 个工具，4 个操作) — 列出、添加、重命名、删除演示文稿节

• 📥 幻灯片导入 (1 个工具，1 个操作) — 从另一个 .pptx 文件导入幻灯片

• 📝 备注 (1 个工具，5 个操作) — 获取、设置、清除、追加、读取所有演讲者备注

• 💬 批注 (1 个工具，4 个操作) — 添加、列出、删除、清除幻灯片批注

• 🔗 超链接 (1 个工具，5 个操作) — 添加、获取、列出、删除、验证超链接

• 🏷️ 标签 (1 个工具，3 个操作) — 幻灯片和形状上的自定义元数据

• 🗂️ 文档属性 (1 个工具，4 个操作) — 获取/设置内置和自定义属性

• ♿ 辅助功能 (1 个工具，3 个操作) — 审计、获取/设置阅读顺序

• 🔤 校对 (1 个工具，3 个操作) — 拼写检查、获取/设置语言

• 📤 导出 (1 个工具，9 个操作) — PDF、幻灯片图像、视频 (MP4)、打印、另存为、提取文本/图像

• 🖨️ 打印选项 (1 个工具，2 个操作) — 获取/设置打印配置

• ⚙️ VBA (1 个工具，5 个操作) — 列出、查看、导入、删除、运行宏

• 🪟 窗口 (1 个工具，7 个操作) — 信息、最小化、还原、最大化、缩放、视图模式

📚 完整功能参考 → — 所有 223 个操作的详细文档

Related MCP server: Office-PowerPoint-MCP

💬 示例提示

创建和构建演示文稿：

• "创建一个名为 QuarterlyReport.pptx 的新 PowerPoint 演示文稿，并包含标题幻灯片"

• "添加 5 张使用“标题和内容”版式的幻灯片"

• "在第一张幻灯片上插入公司徽标图像"

内容和格式：

• "在幻灯片 2 上添加一个文本框，文本为“Q1 Revenue Summary”，加粗 24 磅 Arial"

• "在幻灯片 3 上创建一个表格，列为 Region、Q1、Q2、Q3、Q4"

• "将形状填充颜色设置为 #0078D4，并添加 2 磅边框"

图表和视觉元素：

• "在幻灯片 4 上创建一个柱状图，显示季度收入数据"

• "将图表标题设置为“Revenue by Quarter”"

• "为图表形状添加入场动画"

自动化：

• "将演示文稿导出为 PDF"

• "运行 FormatAllSlides 宏"

• "工作时向我显示 PowerPoint" — 实时查看更改

🪟 代理模式 — 在 PowerPoint 中观看 AI 工作：

• "在构建此演示文稿时并排向我显示 PowerPoint" — 实时可见性

• "让我在创建幻灯片时观看"

• 状态栏显示实时进度："PptMcp: 正在幻灯片 4 上创建图表..."

👥 谁应该使用这个？

非常适合：

• ✅ 演示者 自动化重复的 PowerPoint 工作流

• ✅ 开发人员 构建基于 PowerPoint 的报告解决方案

• ✅ 业务用户 管理复杂的演示文稿集

• ✅ 团队 维护演示文稿模板和 VBA 宏

不适合：

• ❌ 服务器端处理（请改用 Open XML SDK 等库）

• ❌ Linux/macOS 用户（需要 Windows + PowerPoint 安装）

• ❌ 大批量批处理操作（请考虑无需 PowerPoint 的替代方案）

🚀 快速开始

⚠️ 重要提示： 使用前请关闭所有 PowerPoint 文件。服务器在自动化期间需要对演示文稿进行独占访问。

🔧 CLI 与 MCP 服务器

此包同时提供 CLI 和 MCP 服务器 接口。根据你的使用场景选择：

手动安装：

# Install MCP Server and CLI
dotnet tool install --global PptMcp.McpServer
dotnet tool install --global PptMcp.CLI

🤖 可选：从源代码使用官方代理客户端

对于较大的演示文稿构建任务，此仓库还附带一个官方源端控制器：src\PptMcp.Agent。

它有意不是第三个服务器接口。相反，它位于 MCP 服务器之上，并运行一个客户端循环：

• 规划演示文稿

• 通过正常的顺序 MCP 工具调用执行

• 验证生成的演示文稿

• 在需要时修复不完整的输出

快速开始：

dotnet build src\PptMcp.McpServer\PptMcp.McpServer.csproj -c Release

Set-Location src\PptMcp.Agent
npm install
npm run check
npm test

node .\src\cli.mjs run `
  --task "Build a 5-slide executive deck on Q4 revenue performance and next actions." `
  --output "C:\Users\you\Documents\q4-revenue-deck.pptx"

了解更多：

• 代理客户端组件 README

• 代理客户端架构

• 评估框架

• 原型管道

⚙️ 工作原理 — COM 自动化和统一服务架构

PptMcp 使用 Windows COM 自动化来控制实际的 PowerPoint 应用程序（不仅仅是 .pptx 文件）。

MCP 服务器和 CLI 都与管理 PowerPoint 会话的共享 PptMcp 服务通信。这种统一架构支持：

┌─────────────────────┐     ┌─────────────────────┐
│   MCP Server        │     │   CLI (pptcli)    │
│  (AI assistants)    │     │  (coding agents)    │
└─────────┬───────────┘     └─────────┬───────────┘
          │                           │
          └──────────┬────────────────┘
                     ▼
          ┌─────────────────────────┐
          │   PptMcp Service      │
          │  (shared session mgmt)  │
          └─────────┬───────────────┘
                    ▼
          ┌─────────────────────────┐
          │   PowerPoint COM API    │
          │  (PowerPoint.Application)│
          └─────────────────────────┘

主要优势：

• ✅ 共享会话 — CLI 和 MCP 服务器可以访问相同的打开演示文稿

• ✅ 单一 PowerPoint 实例 — 无重复进程或文件锁

• ✅ 系统托盘 UI — 通过 PptMcp 托盘图标监控活动会话

💡 提示：在 AI 工作时观看 PowerPoint

默认情况下，PowerPoint 以隐藏方式运行以加快自动化速度。要实时查看更改，只需询问：

• "工作时向我显示 PowerPoint"

• "让我看看你在做什么"

• "打开 PowerPoint，以便我能看到更改"

AI 将显示 PowerPoint 窗口，以便你可以实时观看每个操作的发生！

📋 附加信息

📚 CLI 指南 → | MCP 服务器指南 → | 代理客户端 → | 评估框架 → | 原型管道 → | 所有代理技能 →

许可证： MIT 许可证 - 请参阅 LICENSE 文件

贡献： 请参阅 CONTRIBUTING.md 获取指南

构建工具： 整个项目是使用 GitHub Copilot AI 辅助开发的 - 主要使用 Claude，但最近使用 Auto-mode。

致谢：

• Microsoft PowerPoint 团队 — 提供全面的 COM 自动化 API

• 模型上下文协议社区 — 提供 AI 集成标准

• 开源社区 — 提供灵感和最佳实践

相关项目

Stefan Broenner 的上游项目：

• mcp-server-excel (upstream) — Stefan Broenner 为 Excel 编写的原始 MCP 服务器

• pytest-aitest — 面向 AI 代理的 LLM 驱动测试框架