PowerPoint MCP 服务器

该项目提供了一个通过模型上下文协议（MCP）自动生成和操作PowerPoint演示文稿的服务器。它使得AI模型或其他客户端能够轻松创建和编辑PowerPoint文档。

主要功能

• 创建新的PowerPoint演示文稿
• 打开现有的PowerPoint文件
• 添加和编辑幻灯片
• 添加文本、图像、表格、图表等元素
• 通过设计系统设置应用一致的样式
• 提供基于MCP协议的API

项目结构

mcp开发/ ├── main.py # 主入口点（新创建） ├── config_loader.py # 配置加载器（新创建） ├── ppt_generator.py # PPT生成模块（从“slide生成.py”重命名） ├── README.md # 文档（从“自动化_PPT_README.md”重命名） ├── requirements.txt # 必需的包列表 ├── data/ # 数据文件夹 │ ├── slide_content.json # 幻灯片内容（从“slide.json”移动） │ └── design_system.json # 设计设置（从“ppt_design_system_config_v2.json”移动） ├── output/ # 存储生成文件的文件夹 └── utils/ # 工具模块文件夹（保持不变）

运行流程

1. 从 main.py 开始
2. 使用 config_loader.py 加载设计设置
3. 使用 ppt_generator.py 处理幻灯片内容并生成PPT
4. 使用 utils 模块操作PowerPoint
5. 最终文件存储在 output 文件夹中

安装方法

要求

• Python 3.6 或更高版本
• python-pptx 库
• mcp 库

安装步骤

# 安装必需的包
pip install python-pptx mcp[cli]

运行方法

启动MCP服务器

python main.py

默认情况下，服务器在localhost:8000运行。如需使用其他主机/端口：

python main.py --host 0.0.0.0 --port 8080

运行测试客户端

python test_client.py

可用工具

演示工具

• create_presentation: 创建新的演示文稿
• open_presentation: 打开现有演示文稿
• save_presentation: 保存演示文稿

幻灯片工具

• add_slide_to_presentation: 向演示文稿添加幻灯片
• add_content_to_slide: 向幻灯片添加内容
• add_bullet_points_to_slide: 向幻灯片添加项目符号

模板工具

• generate_from_template: 使用模板和数据生成演示文稿

故障排除

• 错误：找不到包：使用 pip install python-pptx mcp[cli] 命令安装所需包。
• 错误：无法启动服务器：检查端口是否已被占用，并尝试指定其他端口。
• 错误：无法保存演示文稿：确认输出路径有效且具有写入权限。

文件格式

幻灯片内容文件（JSON）

data/slide_content.json 的基本结构如下所示：

{
  "title": "演示文稿标题",
  "mainTopics": {
    "主题1": {
      "子主题1": { ... },
      "子主题2": { ... }
    },
    "主题2": [ ... ]
  }
}

设计系统设置（JSON）

data/design_system.json 的基本结构如下所示：

{
  "slide_text_settings": {
    "title_font": "Arial",
    "title_font_size": 32,
    ...
  },
  "table_styles": {
    "default": {
      "header_bg_color": [200, 200, 200],
      ...
    }
  },
  ...
}

自定义

内容自定义

可以通过修改 data/slide_content.json 文件来更改演示文稿的内容。

设计自定义

可以通过修改 data/design_system.json 文件来更改设计样式。

代码自定义

可以通过修改 ppt_generator.py 文件中的以下方法来更改幻灯片生成方式：

• _create_title_slide: 创建标题幻灯片
• _create_topic_slides: 创建主题幻灯片
• _create_subtopic_slide: 创建子主题幻灯片
• _create_term_table: 创建术语定义表格
• _create_item_list: 创建项目列表