PowerPoint Automation MCP Server for Claude Desktop

Claude Desktop 的 PowerPoint 自动化 MCP 服务

本项目提供了一个 PowerPoint 自动化服务，可通过模型控制协议（MCP）与 Claude Desktop 协同工作。它支持 Claude 与 Microsoft PowerPoint 交互，从而执行创建演示文稿、添加幻灯片、修改内容等任务。

功能

• 创建、打开、保存和关闭 PowerPoint 演示文稿
• 列出所有已打开的演示文稿
• 获取幻灯片信息和内容
• 使用不同版式添加新幻灯片
• 向幻灯片添加文本框
• 更新形状中的文本内容
• 设置幻灯片标题
• 以及更多！

快速开始

1. 使用 uvx 运行：

uvx --from https://github.com/socamalo/PPT_MCP_Server.git mcp-ppt

安装

1. 克隆此仓库：

2. 安装依赖项：

   uv add fastmcp pywin32
   

3. 配置 Claude Desktop：

   • 打开 Claude Desktop
   • 前往设置
   • 按照下文说明配置 MCP 服务

配置

要将 Claude Desktop 配置为使用此 MCP 服务，请将以下内容添加到 Claude Desktop 配置文件中。该文件位于 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "ppts": {
      "command": "uv",
      "args": ["run", "path/to/main.py"]
    }
  }
}

如果你使用虚拟环境或其他 Python 可执行文件（例如 uv）：

{
  "mcpServers": {
    "ppts": {
      "command": "C:\\Path\\To\\Python\\Scripts\\uv.exe",
      "args": ["run", "C:\\Path\\To\\Project\\main.py"]
    }
  }
}

用法

配置完成后，你可以使用 Claude Desktop 控制 PowerPoint。交互示例：

1. 初始化 PowerPoint：

   Could you open PowerPoint for me?
   

2. 创建新的演示文稿：

   Please create a new PowerPoint presentation.
   

3. 添加幻灯片：

   Add a new slide to the presentation.
   

4. 添加内容：

   Add a text box to slide 1 with the text "Hello World".
   

5. 保存演示文稿：

   Save the presentation to C:\Users\username\Documents\presentation.pptx
   

可用函数

此服务提供以下 PowerPoint 自动化函数：

• initialize_powerpoint()：连接到 PowerPoint 并使其可见
• get_presentations()：列出所有已打开的演示文稿
• open_presentation(path)：打开文件中的演示文稿
• get_slides(presentation_id)：获取演示文稿中的所有幻灯片
• get_slide_text(presentation_id, slide_id)：获取幻灯片的文本内容
• update_text(presentation_id, slide_id, shape_id, text)：更新形状中的文本
• save_presentation(presentation_id, path)：保存演示文稿
• close_presentation(presentation_id, save)：关闭演示文稿
• create_presentation()：创建新的演示文稿
• add_slide(presentation_id, layout_type)：添加新幻灯片
• add_text_box(presentation_id, slide_id, text, left, top, width, height)：添加文本框
• set_slide_title(presentation_id, slide_id, title)：设置幻灯片标题

要求

• 安装了 Microsoft PowerPoint 的 Windows
• Python 3.7+
• Claude Desktop 客户端
• Python 包 pywin32 和 fastmcp

限制

• 仅适用于安装了 PowerPoint 的 Windows
• 操作期间 PowerPoint 应用程序会打开并保持可见
• 功能受限于 PowerPoint COM API 所提供的能力

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

MIT 许可证