Office-PowerPoint-MCP-Server：通过AI助手创建和编辑PowerPoint演示文稿的工具

Office-PowerPoint-MCP-Server 是一个基于 Model Context Protocol（MCP）的服务器工具，专门用于通过 python-pptx 库创建、编辑和管理 PowerPoint 演示文稿。它允许用户通过 AI 助手（如 Claude 或 Cursor）直接操作 PowerPoint，完成创建幻灯片、添加内容、应用主题等任务。项目提供 25 种专业幻灯片模板，支持动态文本调整、渐变背景和交互效果等功能，适合需要快速生成高质量演示文稿的用户。项目开源，代码托管在 GitHub，安装简单，支持本地和云端运行。

功能列表

• 创建和保存 PowerPoint 演示文稿，支持多种文件格式。
• 添加多种类型幻灯片，如标题页、内容页、数据仪表板等。
• 应用 25 种专业幻灯片模板，包含动态文本调整和渐变背景。
• 支持插入文本框、表格、图表、图片和形状，自动调整布局。
• 提供 4 种专业配色方案：现代蓝、商务灰、优雅绿、温暖红。
• 支持动画效果、过渡效果和交互式悬停效果。
• 通过 32 种工具和 11 个模块管理演示文稿的结构和内容。
• 自动验证文本和布局，确保内容符合专业标准。

使用帮助

安装流程

Office-PowerPoint-MCP-Server 提供简单的方式安装和运行。以下是详细步骤：

1. 克隆代码仓库
   在终端运行以下命令，下载项目代码：

   git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
   cd Office-PowerPoint-MCP-Server
   

2. 安装依赖
   使用 Python 的 pip 安装所需依赖：

   pip install -r requirements.txt
   

   或者，使用提供的 setup_mcp.py 脚本自动完成安装：

   python setup_mcp.py
   

3. 配置 MCP 服务器
   编辑 MCP 客户端（如 Claude Desktop 或 Cursor）的配置文件，添加服务器信息。全局配置可编辑 ~/.cursor/mcp.json：

   {
   "mcpServers": {
   "ppt": {
   "command": "python",
   "args": ["/path/to/ppt_mcp_server.py"],
   "env": {}
   }
   }
   }
   

   如果使用 uvx 包管理器，可直接运行无需本地安装：

   {
   "mcpServers": {
   "ppt": {
   "command": "uvx",
   "args": ["--from", "office-powerpoint-mcp-server", "ppt_mcp_server"],
   "env": {}
   }
   }
   }
   

4. 启动服务器
   运行以下命令启动服务器：

   python ppt_mcp_server.py
   

   启动后，服务器通过 MCP 协议与 AI 助手交互。

主要功能操作

以下是主要功能的详细操作流程：

1. 创建新演示文稿
   使用 MCP 工具创建新演示文稿：

   result = use_mcp_tool(server_name="ppt", tool_name="create_presentation", arguments={})
   presentation_id = result["presentation_id"]
   

   这会生成一个新的 PowerPoint 文件，并返回唯一标识 presentation_id。

2. 添加标题幻灯片
   添加标题幻灯片并设置标题和副标题：

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="add_slide",
   arguments={
   "layout_index": 0,  # 标题幻灯片布局
   "title": "我的演示文稿",
   "presentation_id": presentation_id
   }
   )
   slide_index = result["slide_index"]
   result = use_mcp_tool(
   server_name="ppt",
   tool_name="populate_placeholder",
   arguments={
   "slide_index": slide_index,
   "placeholder_idx": 1,  # 副标题占位符
   "text": "由 PowerPoint MCP 服务器创建",
   "presentation_id": presentation_id
   }
   )
   

3. 应用专业设计
   为幻灯片或整个演示文稿应用专业配色和主题：

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="apply_professional_design",
   arguments={
   "operation": "slide",
   "slide_type": "title_content",
   "color_scheme": "modern_blue",
   "title": "季度业务回顾",
   "content": [
   "收入比上季度增长 15%",
   "客户满意度达到 94% 的历史新高",
   "成功推出 3 项新产品功能",
   "团队新增 12 名优秀员工"
   ]
   }
   )
   

   支持的配色方案包括 modern_blue、 corporate_gray、 elegant_green 和 warm_red。

4. 插入图表和表格
   添加带图表的幻灯片：

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="add_slide_title_with_chart",
   arguments={
   "presentation_name": presentation_id,
   "title": "销售趋势",
   "data": {
   "labels": ["Q1", "Q2", "Q3", "Q4"],
   "values": [100, 120, 150, 180]
   }
   }
   )
   

5. 保存演示文稿
   将演示文稿保存为文件：

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="save_presentation",
   arguments={
   "file_path": "my_presentation.pptx",
   "presentation_id": presentation_id
   }
   )
   

6. 查看可用模板
   列出所有 25 种专业幻灯片模板：

   templates = use_mcp_tool(server_name="ppt", tool_name="list_slide_templates", arguments={})
   

特色功能操作

• 动态文本调整：模板支持根据内容长度自动调整文字大小和布局。例如，标题幻灯片会根据输入文字自动调整字体大小。
• 交互效果：支持鼠标悬停时的交互效果，如高亮显示或动画触发，适合交互式演示。
• 专业配色：提供 4 种配色方案，每种方案包含主色、辅色和文字颜色，优化视觉效果。
• 模块化工具：项目包含 11 个模块（如 chart_tools.py、 transition_tools.py），共 32 种工具，覆盖演示文稿创建的方方面面。

注意事项

• 确保 Python 环境安装了 python-pptx 库。
• 操作文件时，检查文件路径权限，避免权限错误。
• 使用 Claude Desktop 或 Cursor 时，需重启客户端以应用 MCP 配置。

应用场景

1. 商务报告
   企业用户可快速生成季度业务报告，添加图表和表格展示数据，使用专业配色提升演示效果。
2. 教育培训
   教师可创建教学演示文稿，插入动态图表和交互内容，吸引学生注意力。
3. 会议展示
   活动组织者可使用模板快速制作会议幻灯片，添加动画和过渡效果，增强观众体验。
4. 数据分析展示
   数据分析师可生成包含图表和趋势线的演示文稿，直观呈现分析结果。

QA

1. 如何安装 Office-PowerPoint-MCP-Server？
   克隆 GitHub 仓库，运行 pip install -r requirements.txt，或使用 setup_mcp.py 脚本自动安装。
2. 支持哪些 AI 助手？
   支持 Claude Desktop、Cursor 等 MCP 客户端，需配置 mcp.json 文件。
3. 如何选择幻灯片模板？
   使用 list_slide_templates 工具查看所有模板，再通过 add_slide 工具指定模板类型。
4. 是否支持自定义配色？
   当前提供 4 种专业配色方案，暂不支持完全自定义，但可通过代码修改配色参数。