Powerpoint MCP server

Powerpoint MCP 服务

一个用于创建 PowerPoint 演示文稿的 MCP 服务项目

此分支的主要更改

使用 Stable Diffusion（ForgeUI/Automatic-1111）API 替代 together ai。

组件

工具

该服务实现了多种工具：

• create-presentation：开始创建演示文稿
  • 必需参数为字符串类型的 "name"
  • 创建一个演示文稿对象
• add-slide-title-only：向演示文稿添加标题页
  • 必需参数为字符串类型的 "presentation_name" 和 "title"
  • 创建包含 "title" 的标题页并将其添加到演示文稿
• add-slide-section-header：向演示文稿添加分节标题页
  • 必需参数为字符串类型的 "presentation_name" 和 "header"
  • 创建包含 "header"（以及可选的 "subtitle"）的分节标题页并将其添加到演示文稿
• add-slide-title-content：向演示文稿添加标题与内容页
  • 必需参数为字符串类型的 "presentation_name"、"title" 和 "content"
  • 创建包含 "title" 和 "content" 的标题与内容页并将其添加到演示文稿
• add-slide-title-with-table：向演示文稿添加带表格的标题页
  • 必需参数为字符串和数组类型的 "presentation_name"、"title" 和 "data"
  • 创建包含 "title" 的标题页，并根据 data 动态构建表格后添加到演示文稿
• add-slide-title-with-chart：向演示文稿添加带图表的标题页
  • 必需参数为字符串和对象类型的 "presentation_name"、"title" 和 "data"
  • 创建包含 "title" 的标题页，并根据 data 动态构建图表后添加到演示文稿。尝试根据数据源确定最合适的图表类型。
• add-slide-picture-with-caption：向演示文稿添加带说明文字的图片页
  • 必需参数为字符串类型的 "presentation_name"、"title"、"caption" 和 "image_path"
  • 使用提供的 "title"、"caption" 和 "image_path" 创建带说明文字的图片页。可以使用通过 "generate-and-save-image" 工具创建的图片，也可以使用用户提供的 "image_path"（图片必须存在于 folder_path 中）
• open-presentation：打开演示文稿以供编辑
  • 必需参数为 "presentation_name"
  • 打开指定的演示文稿，并自动将其备份为 "backup.pptx"
  • 此工具允许客户端使用现有的 pptx 文件并向其中添加幻灯片。只需确保客户端最后调用 "save-presentation" 工具。
• save-presentation：将演示文稿保存到文件。
  • 必需参数为 "presentation_name"。
  • 将演示文稿保存到 folder_path。客户端必须调用此工具以完成操作。
• generate-and-save-image：使用 T2I 模型为演示文稿生成图片
  • 必需参数为字符串类型的 "prompt" 和 "file_name"
  • 使用 Stable Diffusion API（ForgeUI/Automatic1111）创建图片

配置

通过 ForgeUI API 生成图片需要设置环境变量

"env": 
{
  "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
  "SD_AUTH_USER": "your-username",  // Optional: if authentication is enabled
  "SD_AUTH_PASS": "your-password",  // Optional: if authentication is enabled
}

必须指定 folder_path。所有演示文稿和图片都将保存到此文件夹。

"--folder-path",
  "/path/to/decks_folder"

快速开始

安装

确保已安装 UV

MacOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆仓库

git clone https://github.com/Ichigo3766/powerpoint-mcp.git

Claude Desktop（适用于任何 MCP 客户端）

MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows 上：%APPDATA%/Claude/claude_desktop_config.json

• --directory：上面克隆仓库的路径（例如：/full/path/to/powerpoint-mcp/src）
• --folder-path：用于保存 PowerPoint 演示文稿和图片的路径。你也应将希望 MCP 服务使用的图片放在此路径下。

  # Add the server to your claude_desktop_config.json
  "mcpServers": {
    "powerpoint": {
      "command": "uv",
      "env": {
        "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
        "SD_AUTH_USER": "your-username",  // Optional: if authentication is enabled
        "SD_AUTH_PASS": "your-password",  // Optional: if authentication is enabled
      },
      "args": [
        "--directory",
        "/path/to/powerpoint",
        "run",
        "powerpoint",
        "--folder-path",
        "/path/to/decks_folder"
      ]
    }
  }

使用示例

Create a presentation about fish, create some images and include tables and charts

Create a presentation about the attached paper. Please use the following images in the presentation:
author.jpeg

假设你已安装 SQLite MCP Server。

Review 2024 Sales Data table. Create a presentation showing current trends, use tables and charts as appropriate

致谢

本项目是 supercurses 开发的 powerpoint 的一个分支，并添加了功能和修改。原项目为此 MCP 服务奠定了基础。

许可证

此 MCP 服务采用 MIT License 许可。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。