基本能力
产品定位
pptx-xlsx-mcp 是一个用于与 Microsoft Office 应用程序(PowerPoint 和 Excel)交互的 MCP 服务,通过 AI 辅助实现自动化操作。
核心功能
- PowerPoint 功能
- 创建和修改演示文稿
- 添加、删除和修改幻灯片
- 保存和加载演示文稿
- 模板管理系统
- 精细控制幻灯片元素(文本、形状、图像、图表)
- 财务图表创建(线图、柱状图、饼图等)
-
比较表生成
-
Excel 功能
- 连接运行的 Excel 实例
- 列出打开的工作簿
- 保存工作簿
- 添加新工作表
- 读取和写入单元格值
- 处理多种数据类型(文本、数字、日期、货币)
适用场景
- 财务报告生成:自动创建包含财务图表和比较表的 PowerPoint 演示文稿。
- 数据分析:在 Excel 中自动读取、分析和汇总数据。
- 模板管理:使用模板快速生成标准化的演示文稿或工作表。
- 自动化办公:通过自然语言命令自动化完成复杂的 Office 操作。
工具列表
- PowerPoint 工具
list_presentations
:列出工作区中的所有 PowerPoint 文件upload_presentation
:上传新演示文稿save_presentation
:保存当前演示文稿add_slide
:添加新幻灯片delete_slide
:删除幻灯片get_slide_count
:获取幻灯片总数analyze_slide
:分析幻灯片内容add_text
:添加文本add_shape
:添加形状edit_element
:编辑元素属性style_element
:应用样式connect_shapes
:连接形状find_element
:查找元素get_company_financials
:获取公司财务数据(目前为虚拟数据)create_financial_chart
:创建财务图表create_comparison_table
:创建比较表list_templates
:列出所有模板apply_template
:应用模板create_slide_from_template
:从模板创建幻灯片save_as_template
:将幻灯片保存为模板-
debug_element_mappings
:调试元素映射 -
Excel 工具
list_open_workbooks
:列出所有打开的 Excel 工作簿save_workbook
:保存工作簿list_worksheets
:列出所有工作表add_worksheet
:添加新工作表get_worksheet
:获取工作表get_cell_value
:读取单元格值set_cell_value
:设置单元格值get_range_values
:读取单元格范围值set_range_values
:设置单元格范围值
常见问题解答
- 依赖问题:确保已安装 Windows 操作系统和 Microsoft Office。
- COM 自动化问题:运行
pywin32_postinstall.py
脚本以解决 COM 相关错误。 - 文件权限问题:检查文件权限以确保可以读取和写入文件。
- 虚拟数据问题:财务工具目前使用虚拟数据,未来计划集成 Proff API。
使用教程
使用依赖
- 操作系统:Windows
- 软件:Microsoft Office(PowerPoint 和/或 Excel)
- Python:3.7+
- 包:
pywin32
安装教程
-
克隆仓库:
bash
git clone https://github.com/jenstangen1/mcp-pptx.git
cd mcp-pptx -
安装依赖:
bash
uv pip install pywin32 -
运行
pywin32
后安装脚本(需管理员权限):
bash
python C:\path\to\your\env\Scripts\pywin32_postinstall.py -install
调试方式
- 确保 PowerPoint/Excel 正在运行。
- 检查文件权限。
- 验证 COM 自动化是否正常工作。
- 如有需要,运行
pywin32_postinstall.py
。