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" 的标题幻灯片，并添加一个根据数据动态构建的表格
• add-slide-title-with-chart: 向演示文稿中添加一个带有图表的标题幻灯片
  • 需要 "presentation_name", "title", "data" 作为必需的字符串和对象参数
  • 创建一个带有 "title" 的标题幻灯片，并添加一个根据数据动态构建的图表。尝试从数据源中找出最佳的图表类型。
• 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 服务器使用的图片的路径。

  # 将服务器添加到您的 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"
      ]
    }

使用示例

创建一个关于鱼的演示文稿，生成一些图片并包含表格和图表

创建一个关于附件的论文的演示文稿。请在演示文稿中使用以下图片：
author.jpeg

假设您已安装 SQLite MCP 服务器。

查看 2024 年销售数据表。创建一个展示当前趋势的演示文稿，适当使用表格和图表

许可证

此 MCP 服务器根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目仓库中的 LICENSE 文件。