PowerPoint编辑MCP Server

这是一个基于MCP (Model Context Protocol) 的PowerPoint编辑服务器，提供了创建和编辑PowerPoint演示文稿的完整功能，包括内容编辑、格式化和专业动画效果。

✨ 最新更新

• 🎬 全新动画系统 - 添加了多种专业过渡动画效果
• 🚀 一键专业化 - 快速让演示文稿变得专业
• 🎯 智能推荐 - 优化工具描述，提高AI模型使用率
• 🛠️ 便利函数 - 简化复杂操作，提供直观的参数接口

项目结构

• main.py - MCP服务器主程序，处理MCP协议通信
• tool.py - PowerPoint编辑器工具类，包含所有PPT编辑功能
• example.py - 使用示例
• test_transitions.py - 过渡动画功能测试
• transition_improvements_guide.md - 动画功能改进指南
• requirements.txt - 项目依赖
• mcp_config.json - MCP客户端配置文件

功能特性

基础功能

• 创建新的PowerPoint演示文稿
• 打开现有的PowerPoint文件
• 保存演示文稿
• 获取演示文稿信息

幻灯片操作

• 添加新幻灯片（支持不同布局）
• 删除幻灯片
• 复制幻灯片
• 移动幻灯片位置
• 设置幻灯片背景颜色

内容编辑

• 添加文本框和文本内容
• 添加标题幻灯片
• 添加带项目符号的内容
• 插入图片
• 添加各种形状（矩形、椭圆、三角形等）
• 添加表格
• 设置表格单元格文本

格式化功能

• 设置文本格式（字体、大小、颜色、粗体、斜体、下划线）
• 为形状添加超链接
• 获取幻灯片中所有形状的详细信息

🎬 专业动画和过渡效果

• 一键专业化 - 快速为整个演示文稿添加专业过渡效果
• 多种动画风格 - 淡入淡出、推入、擦除、分割、缩放、百叶窗、溶解等8种效果
• 智能速度控制 - 快速、中等、慢速三档速度选择
• 自动播放支持 - 支持自动前进和点击前进
• 批量应用 - 一次性为所有幻灯片设置统一动画
• 便利函数 - 提供流畅过渡、动感效果等预设选项

安装依赖

pip install -r requirements.txt

使用方法

作为MCP Server运行

python main.py

直接使用PowerPointEditor类

from tool import PowerPointEditor

# 创建编辑器实例
editor = PowerPointEditor()

# 创建新演示文稿
editor.create_presentation()

# 添加标题幻灯片
editor.add_title_slide("我的演示文稿", "副标题")

# 保存文件
editor.save_presentation("my_presentation.pptx")

运行示例

python example.py

测试动画功能

python test_transitions.py

🎬 动画功能快速开始

from tool import PowerPointEditor

editor = PowerPointEditor()
editor.create_presentation()

# 添加几张幻灯片
editor.add_title_slide("欢迎", "我的演示文稿")
editor.add_title_slide("内容", "主要内容")
editor.add_title_slide("结束", "谢谢观看")

# 一键专业化 - 为所有幻灯片添加淡入淡出效果
editor.make_presentation_professional()

# 或者添加动感效果
# editor.add_dynamic_effects()

# 保存文件
editor.save_presentation("professional_presentation.pptx")

🛠️ 可用工具

🎬 动画和过渡工具（新增）

add_slide_animation

为单张幻灯片添加动画过渡效果，让演示更生动有趣

• slide_index: 幻灯片索引
• animation_style: 动画风格（fade, push, wipe, zoom, split, blinds, dissolve, none）
• speed: 动画速度（fast, medium, slow）
• auto_advance: 是否自动切换到下一张
• auto_advance_seconds: 自动切换延迟时间

make_presentation_dynamic

为整个演示文稿添加统一的动画效果，制作专业演示文稿的重要步骤

• animation_style: 统一的动画风格（默认fade）
• speed: 动画速度（默认medium）

make_professional_presentation ⭐

一键让演示文稿变得专业！自动为所有幻灯片添加优雅的淡入淡出过渡效果

• 无参数，一键操作

add_smooth_transitions

为演示文稿添加流畅的过渡动画，让幻灯片切换更加自然

• 无参数，预设流畅效果

add_dynamic_effects

为演示文稿添加动感的过渡效果，让演示更有活力

• 无参数，预设动感效果

get_animation_options

查看所有可用的幻灯片动画效果选项

• 无参数

📄 基础工具

1. create_presentation

创建新的PowerPoint演示文稿

2. open_presentation

打开现有的PowerPoint文件

• file_path: 文件路径

3. save_presentation

保存演示文稿

• file_path: 保存路径（可选）

📝 内容编辑工具

4. add_slide

添加新幻灯片

• layout_index: 布局索引（0=标题幻灯片，1=标题和内容）

5. add_text_box

添加文本框

• slide_index: 幻灯片索引
• text: 文本内容
• left, top, width, height: 位置和大小（英寸）
• font_size: 字体大小
• font_color: 字体颜色（十六进制）

6. add_title_slide

添加标题幻灯片

• title: 标题
• subtitle: 副标题（可选）

7. add_bullet_points

添加项目符号内容

• slide_index: 幻灯片索引
• title: 标题
• bullet_points: 项目符号列表

8. add_image

添加图片

• slide_index: 幻灯片索引
• image_path: 图片路径
• left, top: 位置（英寸）
• width, height: 大小（英寸，可选）

9. add_shape

添加形状

• slide_index: 幻灯片索引
• shape_type: 形状类型（rectangle, oval, triangle, diamond, pentagon, hexagon, star, arrow）
• left, top, width, height: 位置和大小（英寸）
• fill_color: 填充颜色（十六进制）

10. add_table

添加表格

• slide_index: 幻灯片索引
• rows: 表格行数
• cols: 表格列数
• left, top, width, height: 位置和大小（英寸）

11. set_table_cell_text

设置表格单元格文本

• slide_index: 幻灯片索引
• table_index: 表格索引
• row: 行索引
• col: 列索引
• text: 文本内容

🎨 格式化和样式工具

12. set_slide_background_color

设置幻灯片背景颜色

• slide_index: 幻灯片索引
• color: 背景颜色（十六进制）

13. add_hyperlink

为形状添加超链接

• slide_index: 幻灯片索引
• shape_index: 形状索引
• url: 超链接URL
• display_text: 显示文本（可选）

14. set_text_formatting

设置文本格式

• slide_index: 幻灯片索引
• shape_index: 形状索引
• font_name: 字体名称（可选）
• font_size: 字体大小（可选）
• font_color: 字体颜色（可选）
• bold: 是否加粗（可选）
• italic: 是否斜体（可选）
• underline: 是否下划线（可选）

🔧 管理工具

15. get_presentation_info

获取演示文稿信息

16. delete_slide

删除幻灯片

• slide_index: 要删除的幻灯片索引

17. duplicate_slide

复制幻灯片

• slide_index: 要复制的幻灯片索引

18. move_slide

移动幻灯片位置

• from_index: 源位置索引
• to_index: 目标位置索引

19. get_slide_shapes_info

获取幻灯片中所有形状的信息

• slide_index: 幻灯片索引

🎬 传统动画工具（向后兼容）

20. set_slide_transition

设置幻灯片过渡效果（推荐使用新的动画工具）

• slide_index: 幻灯片索引
• transition_type: 过渡类型（none, fade, push, wipe, split, zoom, blinds, dissolve）
• duration: 过渡持续时间（秒）
• advance_on_click: 是否点击前进
• advance_after_time: 自动前进时间（秒，可选）

21. get_available_transitions

获取可用的过渡效果列表

• 无参数

💡 使用技巧

让AI更好地使用动画功能

为了让AI模型更主动地使用动画功能，可以在对话中使用这些关键词：

• "让演示更专业" → AI会调用 make_professional_presentation
• "添加动画效果" → AI会使用 add_slide_animation 或 make_presentation_dynamic
• "让幻灯片切换更流畅" → AI会调用 add_smooth_transitions
• "让演示更有活力" → AI会使用 add_dynamic_effects

推荐的工作流程

1. 创建内容 - 先添加所有幻灯片和内容
2. 一键专业化 - 使用 make_professional_presentation() 快速添加过渡效果
3. 个性化调整 - 根据需要为特定幻灯片设置不同的动画效果
4. 预览和保存 - 保存文件并在PowerPoint中预览效果

⚠️ 注意事项

1. 确保安装了所有必需的依赖包（特别是 lxml 用于动画功能）
2. 图片文件路径必须存在且可访问
3. 幻灯片索引从0开始
4. 颜色使用十六进制格式（如：000000表示黑色，FF0000表示红色）
5. 位置和大小单位为英寸
6. 动画效果需要在PowerPoint中打开文件才能看到完整效果

错误处理

所有操作都包含错误处理，返回格式为：

{
  "success": true/false,
  "message": "操作结果消息",
  "error": "错误信息（如果有）"
}

🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目！

📄 许可证

MIT License