Office-PowerPoint-MCP-服务器

一个使用 python-pptx 进行 PowerPoint 操作的 MCP（模型上下文协议）服务器。该服务器提供通过 MCP 协议创建、编辑和操作 PowerPoint 演示文稿的工具。

例子

提示

输出

演示的 GIF -> (./public/demo.mp4)

特征

往返任何 Open XML 演示文稿（.pptx 文件）及其所有元素
添加幻灯片
填充文本占位符，例如创建项目符号幻灯片
将图像以任意位置和大小添加到幻灯片中
在幻灯片中添加文本框；控制文本字体大小和粗体
将表格添加到幻灯片
向幻灯片添加自动形状（例如多边形、流程图形状等）
添加和操作柱形图、条形图、折线图和饼图
访问和更改核心文档属性，例如标题和主题

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 PowerPoint Manipulation Server：

npx -y @smithery/cli install @GongRzhe/Office-PowerPoint-MCP-Server --client claude

先决条件

Python 3.10 或更高版本
pip 包管理器

安装选项

选项 1：使用安装脚本（推荐）

设置 PowerPoint MCP 服务器的最简单方法是使用提供的安装脚本，该脚本可以自动执行安装过程：

python setup_mcp.py

该脚本将：

检查先决条件
提供安装选项：
- 从 PyPI 安装（推荐大多数用户使用）
- 设置本地开发环境
安装所需的依赖项
生成适当的 MCP 配置文件
提供与 Claude Desktop 集成的说明

该脚本根据您的环境提供不同的路径：

如果您安装了uvx ，它将使用 UVX 进行配置（推荐）
如果服务器已经安装，它会提供配置选项
如果服务器未安装，则提供安装方法

选项 2：手动安装

克隆存储库：
git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git cd Office-PowerPoint-MCP-Server
安装依赖项：
pip install -r requirements.txt
使服务器可执行：
chmod +x ppt_mcp_server.py

用法

启动服务器

运行服务器：

python ppt_mcp_server.py

MCP 配置

选项 1：本地 Python 服务器

将服务器添加到您的 MCP 设置配置文件：

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

选项 2：使用 UVX（无需本地安装）

如果您已经安装了uvx ，则可以直接从 PyPI 运行服务器，而无需本地安装：

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

可用工具

演示工具

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

滑动工具

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

文本工具

add_textbox ：向幻灯片添加文本框

图像工具

add_image ：向幻灯片添加图像
add_image_from_base64 ：将 base64 编码字符串中的图像添加到幻灯片

表格工具

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

形状工具

add_shape ：向幻灯片添加自动形状

图表工具

add_chart ：向幻灯片添加图表

示例

创建新的演示文稿

# Create a new presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# Add a title slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # Title slide layout
        "title": "My Presentation",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# Populate subtitle placeholder
result = use_mcp_tool(
    server_name="ppt",
    tool_name="populate_placeholder",
    arguments={
        "slide_index": slide_index,
        "placeholder_idx": 1,  # Subtitle placeholder
        "text": "Created with PowerPoint MCP Server",
        "presentation_id": presentation_id
    }
)

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

添加图表

# Add a chart slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # Content slide layout
        "title": "Sales Data",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# Add a column chart
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_chart",
    arguments={
        "slide_index": slide_index,
        "chart_type": "column",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0,
        "height": 4.5,
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "series_names": ["2023", "2024"],
        "series_values": [
            [100, 120, 140, 160],
            [110, 130, 150, 170]
        ],
        "has_legend": True,
        "legend_position": "bottom",
        "has_data_labels": True,
        "title": "Quarterly Sales",
        "presentation_id": presentation_id
    }
)

执照

麻省理工学院

PowerPoint MCP Server

Integrations