powerpoint-mcp-live

在 PowerPoint 打开时编辑演示文稿——AI 会附着在你已经打开的窗口上，而不会启动自己的窗口。

Live editing · Windows (COM) · 23 tools

大多数 PowerPoint MCP 服务器（包括本工作区自带的 mcp-server-powerpoint）的工作方式是启动一个全新的、不可见的 PowerPoint 进程，在其中打开你的文件，完成后再次关闭它。这对于脚本化生成演示文稿来说很棒，但这意味着 AI 永远不会看到你正在看的同一个窗口。

powerpoint-mcp-live 的做法恰恰相反：它通过 COM 附着到你已经打开的任何 PowerPoint 窗口上，采用与 word-mcp-live 和 excel-mcp-live 相同的"查找正在运行的应用程序"方法。它从不启动 PowerPoint，也从不关闭它——它只操作你自己打开的演示文稿。

要求

• Windows（COM 自动化仅限 Windows——本项目没有 macOS/Linux 模式）

• 已安装 Microsoft PowerPoint 并且已打开一个演示文稿在运行

• Python 3.11+

Related MCP server: mcp-powerpoint

安装

git clone <this-repo-url>
cd powerpoint-mcp-live
pip install -e .

或者使用 uv 直接从源码运行——无需安装步骤：

uv run powerpoint_mcp_server.py

客户端配置（.mcp.json）

将你的 MCP 客户端指向项目目录。对于 Claude Code，请将此添加到项目中的 .mcp.json（或 ~/.claude.json 以进行用户级配置）：

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "uv",
      "args": [
        "--directory",
        "G:/Ai/MCP/powerpoint-mcp-live",
        "run",
        "powerpoint_mcp_server.py"
      ],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

如果你改用 pip install -e . 安装，则可以直接使用控制台脚本：

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "powerpoint-mcp-live",
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

MCP_AUTHOR / MCP_AUTHOR_INITIALS 设置附加到新幻灯片评论的作者姓名/缩写（默认："Author" / ""）。

支持的功能

每个工具都作用于已在 PowerPoint 中打开的演示文稿。presentation 几乎在所有地方都是可选的——省略它即可针对当前活动的演示文稿。

尚未覆盖：表格、图表、SmartArt、动画、切换效果、模板/主题——如需这些功能，请使用 mcp-server-powerpoint，它会启动自己的 PowerPoint 实例，并且操作覆盖范围更广。

示例提示

"I have this deck open — read the text on slide 3 and tell me if the bullets are too long."
"Add a new slide after slide 2 with a blank layout."
"Add a text box on slide 4 that says 'Draft — do not distribute' in red."
"Make the title on slide 1 bold and increase it to 44pt."
"Export slide 5 as an image so I can check whether anything overlaps."
"Add a comment on slide 3 asking if the chart numbers are up to date."

已知限制

• 仅限 Windows。 PowerPoint COM 自动化在 macOS/Linux 上不存在。

• 演示文稿必须已在 PowerPoint 中打开。 此服务器不会创建或打开文件——请参阅 mcp-server-powerpoint。

• 无单次撤销分组。 Word 的 COM API 可以将多次编辑合并为一次 Ctrl+Z；PowerPoint 则不能（Excel 也不能）。执行多次写入的工具调用可能需要多次 Ctrl+Z 才能完全撤销。

• 评论需要 PowerPoint 2016+（现代线程化评论）。

开发

有关架构说明和设计约束，请参阅 CLAUDE.md——特别是为什么此服务器绝不能自行启动或退出 PowerPoint。