/ 目录 / 演练场 / Office PowerPoint MCP
● 社区 GongRzhe ⚡ 即开即用

Office PowerPoint MCP

作者 GongRzhe · GongRzhe/Office-PowerPoint-MCP-Server

从 Claude 构建 .pptx 演示文稿——幻灯片、布局、图表、图片、演讲者备注,以及模板感知的内容插入。

Office PowerPoint MCP 封装了 python-pptx,让 Claude 完全控制 PowerPoint 文件。无需手动打开 PowerPoint,即可从大纲生成演示文稿、用数据填充模板幻灯片、添加图表和图片,并编写演讲者备注。与配套的 Word MCP 配合,可实现文档/演示文稿的完整工作流。

为什么要用

核心特性

实时演示

实际使用效果

office-powerpoint-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "office-powerpoint-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "office-powerpoint-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "office-powerpoint-mcp-server",
          "ppt_mcp_server"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add office-powerpoint-mcp -- uvx --from office-powerpoint-mcp-server ppt_mcp_server

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Office PowerPoint MCP

将 Markdown 大纲转换为精美幻灯片

👤 需要展示研究、状态或 pitch 的任何人 ⏱ ~30 min beginner

何时使用: 你有笔记或文档,明天早上就需要幻灯片。

前置条件
  • 源大纲 — 带 H1/H2 层级的 Markdown 文件
步骤
  1. 选择基础模板
    Use ppt-mcp. Open ~/templates/corporate.pptx and list the available layouts.✓ 已复制
    → 布局列表(标题幻灯片、节标题、内容、双栏内容)
  2. 将大纲映射到幻灯片
    Read outline.md. Each H1 is a section header slide; each H2 is a content slide. Bullet content under each H2.✓ 已复制
    → 计划摘要:N 个节标题,M 张内容幻灯片
  3. 渲染并审查
    Build the deck and save as deck-2026-04-27.pptx. Then read back the slide count and titles for sanity check.✓ 已复制
    → 演示文稿已保存;标题与大纲一致

结果: 演示文稿已可在 PowerPoint 中精细调整,无需从空白开始。

注意事项
  • 自定义模板使用非标准布局名称 — 先列出布局;名称模糊时按索引映射
搭配使用: office-word-mcp

从数据生成图表并嵌入演示文稿

👤 每季度刷新报告的分析师 ⏱ ~25 min intermediate

何时使用: 数字每季度变化,格式固定不变。

前置条件
  • CSV 或内联格式的源数据 — Claude 可读取的任意表格格式
步骤
  1. 为每个指标选择图表类型
    From q1-data.csv, decide chart type per metric (revenue → bar, growth-rate → line, segment-mix → pie).✓ 已复制
    → 每个指标的映射关系
  2. 以原生对象插入图表
    Add each chart on its own slide with the metric name as title. Use the Two Content layout.✓ 已复制
    → 原生图表对象(在 PowerPoint 中可编辑),而非位图

结果: 演示文稿中可编辑的图表;收件人可深入查看。

注意事项
  • 源数据变化时图表不自动更新 — 每季度重新运行生成器;图表已固化在 .pptx 中

根据幻灯片内容为每张幻灯片添加演讲者备注

👤 需要提词器级备稿的演讲者 ⏱ ~20 min beginner

何时使用: 你要临场演讲,需要每张幻灯片的脚本。

步骤
  1. 读取幻灯片内容
    Open the deck. For each slide, extract the visible bullets.✓ 已复制
    → 逐张列出内容
  2. 生成备注
    Write 60-second speaker notes per slide. Conversational, no jargon. Save into the speaker-notes pane.✓ 已复制
    → 每张幻灯片的备注栏已填充

结果: 演示文稿兼作演讲脚本。

组合

与其他 MCP 搭配,撬动十倍杠杆

office-powerpoint-mcp + office-word-mcp

从同一数据源生成匹配的报告和演示文稿

office-powerpoint-mcp + filesystem

渲染演示文稿前从磁盘读取源数据

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
create_presentation filename, template_path? 创建新演示文稿 0
add_slide filename, layout_name 每张新幻灯片 0
set_slide_title filename, slide_index, title 填充标题占位符 0
add_text_box filename, slide_index, text, x, y, w, h 自定义文本覆盖层 0
add_chart filename, slide_index, type, data, position 数据可视化 0
add_image filename, slide_index, image_path, x, y 图片放置 0
set_speaker_notes filename, slide_index, text 逐张幻灯片的演讲备稿 0

成本与限制

运行它的成本

API 配额
不适用——本地运行
每次调用 Token 数
每次调用 100-600
费用
免费(MIT 协议)
提示
逐张构建幻灯片,而非在一个 prompt 中倾倒整个演示文稿计划

安全

权限、密钥、影响范围

最小权限: filesystem-read filesystem-write
凭据存储:
数据出站:

故障排查

常见错误与修复

找不到布局

布局名称因模板而异;先用 list_layouts 枚举确切名称

图表显示为空白

python-pptx 使用 XML 图表引用;确保底层电子表格数据非空

图片超出幻灯片范围

以 EMU 为单位传入明确的宽高;使用 pptx.util.Inches() 辅助函数

替代方案

Office PowerPoint MCP 对比其他方案

替代方案何时用它替代权衡
Office Word MCP你需要的是文档,不是演示文稿不同的功能面;同一作者
Excel MCP Server纯表格数据Excel 用于分析,PPT 用于叙事

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills