PowerPoint本地编辑服务

一个跨平台的本地PowerPoint编辑服务,支持通过Claude创建和编辑演示文稿,无需外部API调用,适用于企业环境。

  • by juanocampo400
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 juanocampo400/powerpoint-mcp

使用说明

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代码(也称为“逃逸舱口”)