使用说明
PowerPoint MCP服务器
使用Claude在本地或任何平台上创建和编辑PowerPoint演示文稿。
为什么存在
我想要一个可以在任何机器上运行的PowerPoint MCP服务器,即使有公司的IT限制。
我尝试过的其他服务器有:
- 外部API调用 –被防火墙阻止,需要API密钥,依赖于第三方服务
- COM自动化 仅限Windows,需要打开PowerPoint,在工作时窃取焦点
- 工具太多 –30多种我从未使用过的动画和功能工具,运行缓慢
此服务器是:
- 100%本地 –没有外部API调用,文件操作通过python-ptx在本地进行
- 跨平台 –适用于Windows、macOS和Linux
- 非侵入式 –在后台运行,不启动窃取焦点的窗口
- 轻量级 –适用于95%用例的精益工具集
入门指南
先决条件
Python 3.8+ -查看 python3 --version
如果未安装:
- macOS:
brew install python - Windows:使用安装
winget isntall Python.Python.3.13或从微软商店安装(搜索“Python 3.13”) - Linux:使用你的包管理器
安装
1.克隆仓库:
git clone https://github.com/juanocampo400/powerpoint-mcp.git
cd powerpoint-mcp
2.安装依赖项:
macOS/Linux:
pip3 install -r requirements.txt
窗户:
pip install -r requirements.txt
3.在克劳德代码中添加:
macOS:
chmod +x server.sh
claude mcp add powerpoint-mcp --scope user -- $PWD/server.sh
Windows(Git Bash):
claude mcp add powerpoint-mcp --scope user -- python $PWD/server.py
Linux:
claude mcp add powerpoint-mcp --scope user -- python3 "$PWD/server.py"
图标支持(可选):
- 窗户:
pip install cairosvg(如果安装了pycairo,则有效,与图形/PDF工具通用) - macOS:
brew install cairo pango && pip3 install cairosvg - Linux:为您的发行版安装Cairo,然后
pip3 install cairosvg
Manual configuration & platform/icons notes
为什么 --scope user? 使服务器在全球范围内可用。没有它,服务器只能在项目目录中工作。
为什么 server.sh 在macOS上? 包装器脚本设置 DYLD_FALLBACK_LIBRARY_PATH 因此Python可以找到Homebrew安装的cairo库(图标支持所需)。
为什么选择荧光图标? 基于填充的SVG(与Lucide的基于笔划的SVG不同)在PowerPoint中可以重新着色。1000+个设计(与Heroicons的~300个相比)。麻省理工学院许可。
手动配置 –编辑 ~/.claude.json:
macOS:
{
"mcpServers": {
"powerpoint-mcp": {
"type": "stdio",
"command": "/Users/yourname/powerpoint-mcp/server.sh",
"args": []
}
}
}
窗户:
{
"mcpServers": {
"powerpoint-mcp": {
"type": "stdio",
"command": "C:/Users/yourname/AppData/Local/Programs/Python/Python312/python.exe",
"args": ["C:/Users/yourname/powerpoint-mcp/server.py"]
}
}
}
打造你的第一个甲板
打开克劳德代码并说:
“创建一个关于[主题]的5页演示文稿”
Claude将创建一个.pptx文件,也可以随意指定文件路径。
获得更好的结果
这是开箱即用的。但为了获得一致的输出,这里有一个建议的进展:
使用模板
下载现有模板或PowerPoint库中的模板,将其保存到工作文件夹中,并让Claude使用它:
“使用我文件夹中的模板创建关于[主题]的演示文稿”
准备模板
为了获得更好的结果,请先准备模板或让Claude为您准备模板:
“从该模板中删除现有文本,并将其替换为通用占位符文本,使其可重复使用”
然后对布局、图标位置、文本框大小进行自己的调整。继续使用此准备好的模板。
创造技能
一旦你建立了一个工作流程,就把它和你的故事讲述和品牌指导方针打包成克劳德代码技能。克劳德会自动跟随他们。
一位测试人员指出: “我用PowerPoint MCP和我的一个分析MCP制作了一个构建演讲板的技能,它们配合得很好……我上传了一个模板到该技能中,它运行得更快。不到1分钟。”
备注
- 位置和尺寸使用 英寸
- 颜色是十六进制代码(例如。,
#FF0000红色) - 捆绑1500+荧光粉图标
- 一次在内存中打开一个演示文稿
可用工具
演示文稿和幻灯片
| 工具 | 说明 |
|---|---|
manage_presentation |
打开、创建、保存、另存为、关闭演示文稿 |
get_presentation_info |
获取幻灯片数量、尺寸、概述 |
manage_slide |
添加、删除、复制、移动幻灯片 |
get_slide_snapshot |
获取幻灯片上形状的详细信息 |
内容创作
| 工具 | 说明 |
|---|---|
add_textbox |
添加具有格式(字体、大小、颜色、对齐方式、项目符号)的文本 |
add_image |
插入具有拟合模式(填充、拟合、拉伸)的图像 |
add_shape |
添加形状(矩形、椭圆形、箭头、星形等) |
add_table |
用数据创建表 |
add_chart |
创建图表(柱状图、柱状图、折线图、饼图、面积图) |
insert_icon |
插入荧光SVG图标 |
list_icons |
按类别列出可用图标 |
修改
| 工具 | 说明 |
|---|---|
modify_shape |
更改形状的位置、大小、颜色和文本 |
delete_shape |
按ID或名称删除形状 |
find_and_replace |
在幻灯片中查找和替换文本(保留格式) |
get_table_content |
获取完整表数据(行/列) |
modify_table_cell |
更新单个表单元格(保留格式) |
高级
| 工具 | 说明 |
|---|---|
evaluate_code |
在边缘情况下执行任意python pptx代码(也称为“逃逸舱口”) |