PowerPoint 自动化 MCP 服务器用于 Claude Desktop

该项目提供了一个与 Claude Desktop 通过模型控制协议（MCP）协作的 PowerPoint 自动化服务器。它允许 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 服务器，请在位于 %APPDATA%\Claude\claude_desktop_config.json 的 Claude Desktop 配置文件中添加以下内容：

{
  "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：

   能否帮我打开 PowerPoint？
   

2. 创建新的演示文稿：

   请创建一个新的 PowerPoint 演示文稿。
   

3. 添加幻灯片：

   将一张新幻灯片添加到演示文稿中。
   

4. 添加内容：

   在第 1 张幻灯片上添加一个文本框，内容为“Hello World”。
   

5. 保存演示文稿：

   将演示文稿保存到 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 客户端
• pywin32 和 fastmcp Python 包

限制

• 仅在安装了 PowerPoint 的 Windows 上工作
• 在操作期间，PowerPoint 应用程序会打开并可见
• 限于 PowerPoint COM API 提供的功能

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT 许可证 </中文翻译>