AI导哈

PowerPoint自动化协议

Office-PowerPoint-MCP是一个强大的模型上下文协议（MCP）服务器，旨在为AI助手提供高级PowerPoint演示文稿处理能力，支持创建、读取、操作和分析.pptx文件。

  • by ihatesea69
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 ihatesea69/office-powerpoint-mcp-server

使用说明

Office PowerPoint MCP

面向AI助手的企业级PowerPoint自动化协议

概述

Office PowerPoint MCP 是一个强大的模型上下文协议（MCP）服务器，旨在为AI助手提供高级PowerPoint演示文稿处理功能，如 克劳德代码, 亚马逊Q开发者以及其他符合MCP的客户端。

它为AI代理提供了一个标准化的界面，以编程方式创建、阅读、操作和分析Microsoft PowerPoint演示文稿(.pptx).通过将复杂的演示对象模型抽象到干净的API工具中，它使人工智能助手能够自主生成专业演示、报告和可视化文档工作流。

主要优势

  • 无缝集成：针对Claude Code和Amazon Q环境进行了优化
  • 丰富的格式：支持复杂的布局、动画和设计控件
  • 企业级就绪：包括模板管理、媒体处理和专业造型
  • 安全：在本地运行，具有明确的权限控制

特性

1.演示文稿管理

  • 生命周期控制：创建、复制、合并和转换演示文稿（PDF）
  • 结构分析：提取幻灯片内容、元数据和统计信息
  • 模板系统：应用和管理自定义演示文稿模板

2.内容工程

  • 高级布局：创建具有多个内容区域的复杂幻灯片布局
  • 富媒体：插入具有精确定位的图像、视频、图表和表格
  • 动态文本：字体、颜色和段落样式的精度控制
  • 交互式元素：添加动画、过渡和超链接

3.设计与造型

  • 主题管理：应用和自定义演示主题
  • 主幻灯片：创建和修改幻灯片母版，以实现一致的品牌
  • 配色方案：实施公司调色板和设计系统

入门指南

先决条件

  • Python 3.10或更高版本
  • uv （推荐）或 pip 包管理器
  • Microsoft PowerPoint（用于高级功能）

安装

选项1：使用 uvx （建议短暂使用）

无需安装。您可以直接使用以下命令运行服务器 uvx.

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

选项2：本地安装

克隆存储库并安装依赖项：

git clone https://github.com/ihatesea69/Office-PowerPoint-MCP.git
cd Office-PowerPoint-MCP
pip install -r requirements.txt

集成指南

克劳德代码

将以下内容添加到您的Claude Code MCP配置中：

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

亚马逊Q开发人员（VS代码/JetBrains）

要将Office PowerPoint MCP与Amazon Q Developer集成，请执行以下操作：

  1. 打开IDE设置并导航到 亚马逊Q > MCP服务器
  2. 添加新的服务器配置：
    • 名字: powerpoint-automation
    • 命令: uvx
    • 参数: --from, office-powerpoint-mcp-server, ppt_mcp_server
  3. 重新启动IDE。亚马逊Q现在可以访问PowerPoint工具

其他MCP客户端

将以下内容添加到MCP配置文件中：

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

API 参考

服务器向AI助手公开以下工具。

核心业务

工具名称 描述
create_presentation 创建新的空白或基于模板的演示文稿
get_presentation_info 提取元数据和结构信息
list_available_presentations 扫描目录以查找有效的PowerPoint文件
convert_to_pdf 将.pptx导出为PDF格式

内容和格式

工具名称 描述
add_slide 插入具有指定布局的新幻灯片
add_text_box 在幻灯片中添加格式化文本框
add_image 插入具有定位和缩放功能的图像
add_table 在幻灯片上创建结构化表格
add_chart 生成图表和图形

设计管理

工具名称 描述
apply_theme 应用预定义或自定义主题
set_slide_layout 更改幻灯片布局和主模板
format_text 应用高级文本格式选项
add_animation 创建幻灯片过渡和动画

示例用法

# Example: Create a business presentation
presentation = create_presentation("Business Report Q4 2024")
add_slide(presentation, "title_slide", title="Q4 Results", subtitle="Company Performance Review")
add_slide(presentation, "content_slide", title="Key Metrics")
add_chart(presentation, slide_index=1, chart_type="bar", data=sales_data)
apply_theme(presentation, "corporate_blue")
save_presentation(presentation, "Q4_Report.pptx")

故障排除

常见问题

权限不足

  • 原因：服务器无法访问文件系统
  • 修复：确保正在运行的进程具有对目标目录的R/W访问权限。在Windows上，确保该文件未在Microsoft PowerPoint中打开

找不到模板

  • 原因：使用系统中不存在的模板
  • 修复：使用 list_available_templates 查看可用选项，或提供自定义模板的完整路径

图像插入失败

  • 原因：相对路径可能不明确
  • 修复：始终使用 绝对路径 对于图像

调试

设置 MCP_DEBUG 环境变量到 1 要启用详细日志记录，请执行以下操作：

# Windows (PowerShell)
$env:MCP_DEBUG = "1"

# Linux/Mac
export MCP_DEBUG=1

贡献

我们欢迎捐款！请看 贡献.md 作为指导方针。

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。

路线图

  • []高级动画支持
  • []与在线模板库集成
  • []协同编辑功能
  • []人工智能驱动的设计建议
  • []支持PowerPoint Online/Office 365

专为人工智能驱动的生产力时代而打造。

相关 MCP