Office-PowerPoint-MCP-Server

Office-PowerPoint-MCP-Server

site icon
2025.04.16 43
PythonPowerPoint 自动化文档处理办公自动化内容生成开发效率
Office-PowerPoint-MCP-Server 是一个基于 MCP (Model Context Protocol) 的 PowerPoint 操作服务器,使用 python-pptx 库提供创建、编辑和操作 PowerPoint 演示文稿的功能。该服务器支持多种 PowerPoint 元素的操作,包括幻灯片、文本、图像、表格、形状和图表等。
View on GitHub

Overview

基本能力

产品定位

Office-PowerPoint-MCP-Server 是一个专门用于 PowerPoint 文档操作的 MCP 服务器,旨在通过编程方式自动化 PowerPoint 演示文稿的创建和编辑过程。

核心功能

  • 支持任何 Open XML 演示文稿 (.pptx 文件) 的往返操作
  • 添加幻灯片
  • 填充文本占位符,例如创建项目符号幻灯片
  • 在幻灯片上任意位置和大小添加图像
  • 向幻灯片添加文本框;操作文本字体大小和加粗
  • 向幻灯片添加表格
  • 向幻灯片添加自动形状(如多边形、流程图形状等)
  • 添加和操作柱状图、条形图、折线图和饼图
  • 访问和更改核心文档属性,如标题和主题

适用场景

  • 自动化生成 PowerPoint 演示文稿
  • 批量处理 PowerPoint 文件
  • 动态生成数据可视化图表
  • 企业报告自动化生成
  • 教育课件自动化制作

工具列表

Presentation Tools

  • create_presentation: 创建新的 PowerPoint 演示文稿
  • open_presentation: 从文件打开现有的 PowerPoint 演示文稿
  • save_presentation: 将当前演示文稿保存到文件
  • get_presentation_info: 获取当前演示文稿的信息
  • set_core_properties: 设置当前演示文稿的核心文档属性

Slide Tools

  • add_slide: 向当前演示文稿添加新幻灯片
  • get_slide_info: 获取特定幻灯片的信息
  • populate_placeholder: 用文本填充占位符
  • add_bullet_points: 向占位符添加项目符号

Text Tools

  • add_textbox: 向幻灯片添加文本框

Image Tools

  • add_image: 向幻灯片添加图像
  • add_image_from_base64: 从 base64 编码字符串向幻灯片添加图像

Table Tools

  • add_table: 向幻灯片添加表格
  • format_table_cell: 格式化表格单元格

Shape Tools

  • add_shape: 向幻灯片添加自动形状

Chart Tools

  • add_chart: 向幻灯片添加图表

常见问题解答

  1. 如何安装服务器? 提供了两种安装方式:使用设置脚本(推荐)或手动安装。

  2. 需要哪些前置条件? 需要 Python 3.6 或更高版本以及 pip 包管理器。

  3. 如何配置服务器? 可以通过本地 Python 服务器或使用 UVX 进行配置。

使用教程

使用依赖

  • Python 3.6 或更高版本
  • pip 包管理器

安装教程

选项1:使用设置脚本(推荐)

python setup_mcp.py

选项2:手动安装

  1. 克隆仓库: bash git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git cd Office-PowerPoint-MCP-Server

  2. 安装依赖: bash pip install -r requirements.txt

  3. 使服务器可执行: bash chmod +x ppt_mcp_server.py

调试方式

  1. 启动服务器: bash python ppt_mcp_server.py

  2. 检查服务器是否正常运行

  3. 使用提供的工具进行测试操作
  4. 查看生成的 PowerPoint 文件是否符合预期

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。