Skip to main content
Glama
PowerPoint MCP Server

PowerPoint MCP Server

by Ichigo3766

Powerpoint MCP 服务器

创建 PowerPoint 演示文稿的 MCP 服务器项目

本次分叉的主要变化

使用稳定扩散 (ForgeUI/Automatic-1111) API 代替共同人工智能。

Related MCP server: PowerPoint Editor MCP Server

成分

工具

服务器实现了多个工具:

  • create-presentation :开始演示

    • 将“name”作为必需的字符串参数

    • 创建一个演示对象

  • add-slide-title-only :向演示文稿添加标题幻灯片

    • 将“presentation_name”和“title”作为必需的字符串参数

    • 创建带有“标题”的标题幻灯片并将其添加到演示文稿中

  • add-slide-section-header :向演示文稿添加节标题幻灯片

    • 将“presentation_name”和“header”作为必需的字符串参数

    • 创建带有“标题”(以及可选的“副标题”)的章节标题幻灯片并将其添加到演示文稿中

  • add-slide-title-content :向演示文稿添加带有内容幻灯片的标题

    • 将“presentation_name”、“title”、“content”作为必需的字符串参数

    • 创建带有“标题”和“内容”的内容幻灯片标题,并将其添加到演示文稿中

  • add-slide-title-with-table :添加带有表格的标题幻灯片

    • 将“presentation_name”、“title”、“data”作为必需的字符串和数组参数

    • 创建带有“标题”的标题幻灯片,并添加一个由数据动态构建的表格

  • 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 :使用 T2I 模型生成用于演示的图像

    • 将“prompt”和“file_name”作为必需的字符串参数

    • 使用稳定扩散 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

视窗

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

克隆 repo

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 :您克隆上述 repo 的路径(例如:/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 服务器。

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

致谢

该项目是supercurses开发的powerpoint的一个分支,添加了更多功能和修改。原始项目为本 MCP 服务器提供了基础。

执照

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

Available Tools

11 tools
add-slide-comparisonA

Add a new a comparison slide with title and comparison content. Use when you wish to compare two concepts

Inputs: left_side_content (required), left_side_title (required), presentation_name (required), right_side_content (required), +2 more.

add-slide-picture-with-captionC

Add a new slide with a picture and caption to an existing presentation

Inputs: caption (required), image_path (required), presentation_name (required), title (required).

add-slide-section-headerC

This tool adds a section header (a.k.a segue) slide to the presentation you are working on. The tool doesn't return anything. It requires the presentation_name to work on.

Inputs: header (required), presentation_name (required), subtitle.

add-slide-title-contentC

Add a new slide with a title and content to an existing presentation

Inputs: content (required), presentation_name (required), title (required).

add-slide-title-onlyB

This tool adds a new title slide to the presentation you are working on. The tool doesn't return anything. It requires the presentation_name to work on.

Inputs: presentation_name (required), title (required).

add-slide-title-with-chartC

Add a new slide with a title and chart. The chart type will be automatically selected based on the data structure.

Inputs: data (required), presentation_name (required), title (required).

add-slide-title-with-tableC

Add a new slide with a title and table containing the provided data

Inputs: data (required), presentation_name (required), title (required).

create-presentationB

This tool starts the process of generating a new powerpoint presentation with the name given by the user. Use this tool when the user requests to create or generate a new presentation.

Inputs: name (required).

generate-and-save-imageB

Generates an image using a FLUX model and save the image to the specified path. The tool will return a PNG file path. It should be used when the user asks to generate or create an image or a picture.

Inputs: file_name (required), prompt (required).

open-presentationB

Opens an existing presentation and saves a copy to a new file for backup. Use this tool when the user requests to open a presentation that has already been created.

Inputs: presentation_name (required), output_path.

save-presentationA

Save the presentation to a file. Always use this tool at the end of any process that has added slides to a presentation.

Inputs: presentation_name (required), output_path.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct purposes focused on slide types or presentation management, but 'generate-and-save-image' stands out as unrelated to PowerPoint operations, potentially causing confusion. The slide-adding tools are well-differentiated by content type (comparison, picture, title-only, etc.), making them easy to distinguish for their specific use cases.

    Naming Consistency4/5

    The naming follows a consistent 'verb-noun' pattern with hyphens (e.g., add-slide-comparison, create-presentation), which is clear and predictable. However, 'generate-and-save-image' deviates slightly by including an 'and' conjunction, breaking the pure verb-noun flow, though it remains readable and understandable.

    Tool Count4/5

    With 11 tools, the count is reasonable for a PowerPoint server, covering slide creation, presentation management, and an image generation tool. It's slightly on the higher side but well-scoped for the domain, with each tool serving a specific function without obvious redundancy.

    Completeness3/5

    The toolset covers core presentation operations like creating, opening, saving, and adding various slide types, but lacks tools for editing or deleting slides, updating content, or managing slide order. The inclusion of 'generate-and-save-image' adds an unrelated capability, but for PowerPoint-specific tasks, there are notable gaps in lifecycle coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers