MCP 服务器

PowerPoint MCP Server

一个服务器，可以通过模型上下文协议以编程方式创建和编辑 PowerPoint 演示文稿，支持添加幻灯片、图像、文本框、图表和表格等功能。

README

Office-PowerPoint-MCP-Server

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

示例

提示

输出

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

demo

特性

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

安装

前提条件

Python 3.6 或更高版本
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: 向幻灯片添加图表

示例

创建新的演示文稿

# 创建新的演示文稿
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# 添加标题幻灯片
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # 标题幻灯片布局
        "title": "My Presentation",
        "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": "Created with PowerPoint MCP Server",
        "presentation_id": presentation_id
    }
)

# 保存演示文稿
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "my_presentation.pptx",
        "presentation_id": presentation_id
    }
)

添加图表

# 添加图表幻灯片
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # 内容幻灯片布局
        "title": "Sales Data",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# 添加柱形图
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
    }
)