powerpoint MCP server

powerpoint MCP 服务

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

组件

工具

此服务实现了多个工具：

• 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：使用 FLUX 模型为演示文稿生成图片
  • 必须提供字符串参数 "prompt" 和 "file_name"
  • 使用 TogetherAI 上的免费 FLUX 模型生成图片（需要 API 密钥）

配置

通过 TogetherAI 生成图片需要设置环境变量 注册账号：https://api.together.xyz/settings/api-keys

"env": {
        "TOGETHER_API_KEY": "api_key"
      }

必须设置 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/supercurses/powerpoint.git

Claude Desktop

MacOS 配置文件路径：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows 配置文件路径：%APPDATA%/Claude/claude_desktop_config.json

• --directory：上述克隆代码仓库的路径
• --folder-path：保存 PowerPoint 演示文稿和图片的路径。你也应将希望 MCP 服务使用的图片放在此路径中。

  # Add the server to your claude_desktop_config.json
  "mcpServers": {
    "powerpoint": {
      "command": "uv",
      "env": {
        "TOGETHER_API_KEY": "api_key"
      },
      "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

许可证

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