PPT-Agent

Create, edit, and manage PowerPoint presentations using large language models.

View on GitHub →

PPT-Agent MCP服务器

PPT-Agent MCP服务器提供了通过大型语言模型（LLM）创建、编辑和管理PowerPoint演示文稿的能力。该服务器实现了Model Context Protocol (MCP)规范，使LLM能够通过标准接口与PPT-Agent工具进行交互。

功能概述

PPT-Agent MCP服务器提供以下功能：

  • 创建和保存PowerPoint演示文稿
  • 添加和管理幻灯片
  • 设置幻灯片背景颜色和SVG背景
  • 添加各种形状和线条
  • 添加文本框和格式化文本
  • 导入SVG图像
  • 添加图片
  • 获取幻灯片的已有信息

技术架构

  • 核心框架：使用Model Context Protocol SDK实现MCP服务器功能
  • 传输层：支持STDIO（标准输入/输出）传输，便于与Claude等LLM客户端集成
  • 工具实现：基于Aspose.Slides库提供的PowerPoint操作功能
  • 异步处理：使用Project Reactor实现异步响应处理

构建项目

使用Maven构建项目：

mvn clean package

这将生成两个JAR文件：

  • 标准JAR文件：target/pptagent-0.0.1-SNAPSHOT.jar
  • 包含所有依赖的可执行JAR文件：target/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar

运行服务器

使用Java命令运行

java -jar target/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar

与Claude Desktop集成

要在Claude Desktop中使用此MCP服务器，您需要编辑Claude Desktop的配置文件，将PPT-Agent添加为MCP服务器：

  1. 找到Claude Desktop配置文件：

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. 添加PPT-Agent配置：

{
  "mcpServers": {
    "ppt-agent": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar"
      ]
    }
  }
}
  1. 重启Claude Desktop应用

明白！下面是按照你当前 README 的风格、只列出工具名称和一句话功能描述的补充版。你可以直接将这些内容插入到“可用工具”部分，丰富工具列表。

基础工具

  • createPresentation - 创建新的空白演示文稿
  • savePresentation - 保存演示文稿到指定路径

幻灯片工具

  • addSlide - 添加新的幻灯片
  • selectSlide - 选择当前操作的幻灯片

背景工具

  • setBackgroundColor - 设置幻灯片背景颜色
  • setBackgroundSvg - 设置幻灯片SVG背景

形状工具

  • addShape - 添加形状到幻灯片
  • addLine - 添加线条到幻灯片

图表工具

  • addColumnChart - 添加柱状图到幻灯片
  • addPieChart - 添加饼图到幻灯片
  • addLineChart - 添加折线图到幻灯片

动画工具

  • addAnimation - 为形状添加动画效果
  • addParagraphAnimation - 为文本段落添加动画效果

图片/媒体工具

  • addPictureFrameWithAspectRatio - 添加并保持原比例的图片
  • addPictureFrameFromBase64 - 通过Base64数据添加图片
  • addPictureFrameWithFormat - 添加图片并设置边框和旋转
  • addPictureFrameFromBase64WithFormat - 通过Base64数据添加图片并设置边框和旋转

SVG工具

  • addSvgImage - 添加SVG图像到幻灯片

文本工具

  • addTextBox - 添加文本框到幻灯片
  • setFormattedText - 设置形状的格式化文本

信息工具

  • getShapesInfo - 获取幻灯片中所有形状的信息
  • getSlideCount - 获取演示文稿的幻灯片数量

使用示例

以下是一些使用示例，展示如何通过LLM使用PPT-Agent工具：

  1. 创建新的演示文稿：

    请创建一个新的演示文稿

  2. 添加标题幻灯片：

    在演示文稿中添加一个标题幻灯片，然后添加标题"PPT-Agent演示"

  3. 添加内容幻灯片：

    添加一个新的空白幻灯片，设置背景为浅蓝色，然后添加一个标题"主要功能"

技术详情

PPT-Agent MCP服务器使用以下技术：

  • Java 16
  • Aspose.Slides (用于PPT操作)
  • Model Context Protocol SDK (用于MCP实现)
  • Project Reactor (用于异步响应处理)

自定义和扩展

要添加新的工具，您需要：

  1. 在现有工具类中添加新方法
  2. 在对应的工具注册器中创建新的工具规范
  3. 更新README中的工具列表

许可证

此项目使用 MIT 许可证。请参阅 LICENSE 文件获取详情。

Related Servers