# PowerPoint MCP 服务器
## 基本信息
- Slug: `gongrzhe-office-powerpoint-mcp-server`
- Source: modelscope
- Publisher: @GongRzhe/Office-PowerPoint-MCP-Server
- Categories: file-systems / developer-tools
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@GongRzhe/Office-PowerPoint-MCP-Server
## 简介
通过模型上下文协议（Model Context Protocol）实现创建和编辑 PowerPoint 演示文稿的服务器，支持添加幻灯片、图像、文本框、图表和表格等功能。
## 安装提示

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

## MCP Server 详情

# Office-PowerPoint-MCP-Server
[![smithery badge](https://smithery.ai/badge/@GongRzhe/Office-PowerPoint-MCP-Server)](https://smithery.ai/server/@GongRzhe/Office-PowerPoint-MCP-Server)
![](https://badge.mcpx.dev?type=server 'MCP Server')

这是一个使用 `python-pptx` 的 PowerPoint 操控 MCP（Model Context Protocol）服务器。该服务器通过 MCP 协议提供创建、编辑和操控 PowerPoint 演示文稿的工具。

### 示例

#### 提示

<img width="1280" alt="650f4cc5d0f1ea4f3b1580800cb0deb" src="https://github.com/user-attachments/assets/90633c97-f373-4c85-bc9c-a1d7b891c344" />

#### 输出

<img width="1640" alt="084f1cf4bc7e4fcd4890c8f94f536c1" src="https://github.com/user-attachments/assets/420e63a0-15a4-46d8-b149-1408d23af038" />

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

![demo](./public/demo.gif)

## 功能

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

## 安装

### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@GongRzhe/Office-PowerPoint-MCP-Server) 自动为 Claude Desktop 安装 PowerPoint 操控服务器：

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


### 先决条件

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

### 安装选项

#### 选项 1：使用设置脚本（推荐）

最简单的方法是使用提供的设置脚本来配置 PowerPoint MCP 服务器，该脚本会自动化安装过程：

```bash
python setup_mcp.py
```


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

该脚本根据您的环境提供不同的路径：
- 如果您已安装 `uvx`，它将使用 UVX 进行配置（推荐）
- 如果服务器已经安装，它会提供配置选项
- 如果服务器未安装，它会提供安装方法

#### 选项 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
   ```

## 使用

### 启动服务器

运行服务器：

```bash
python ppt_mcp_server.py
```


### MCP 配置

#### 选项 1：本地 Python 服务器

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

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


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

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

```json
{
  "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**: 向幻灯片添加一个图表

## 示例

### 创建一个新的演示文稿

```python
# 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
    }
)
```


### 添加一个图表

```python
# 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
    }
)
```


## 许可证

MIT