关键词

PowerPoint演示文稿幻灯片制作文档生成图片生成

使用说明

项目简介

PowerPoint演示文稿服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为LLM客户端提供创建和编辑PowerPoint演示文稿的能力。通过标准化的MCP协议，该服务器提供了一系列工具，允许LLM客户端操控演示文稿的创建、内容添加和保存等操作，极大地扩展了LLM在文档生成和演示方面的应用场景。

主要功能点

  • 创建演示文稿: 允许LLM客户端创建新的PowerPoint演示文稿。
  • 添加多种类型的幻灯片: 支持添加包含标题、内容、节标题、比较内容、表格、图表以及带标题和说明的图片的幻灯片。
  • 图片生成: 集成图像生成工具，可以根据文本描述生成并保存图片，用于演示文稿中。
  • 打开和保存演示文稿: 支持打开已有的演示文稿进行编辑，并将编辑后的演示文稿保存到指定位置。

安装步骤

  1. 安装UV: 确保已安装UV包管理器。根据您的操作系统（MacOS/Linux 或 Windows）运行相应的安装命令。
    • MacOS/Linux: 
      curl -LsSf https://astral.sh/uv/install.sh | sh
    • Windows: 
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  2. 克隆仓库: 使用git克隆PowerPoint演示文稿服务器仓库到本地。 
    git clone https://github.com/supercurses/powerpoint.git
  3. 配置环境变量: 如果需要使用图片生成功能，您需要在系统中配置 'TOGETHER_API_KEY' 环境变量，用于访问TogetherAI的API。请先注册TogetherAI账户并获取API密钥。
  4. 配置文件夹路径: 您需要指定一个文件夹路径，用于存放生成的演示文稿和图片。这个路径将在服务器配置中设置。

服务器配置

要将PowerPoint演示文稿服务器配置为MCP服务器供客户端（例如Claude Desktop）使用，您需要编辑客户端的配置文件（例如Claude Desktop的 'claude_desktop_config.json' 文件）。

Claude Desktop 配置文件路径：

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

在 'claude_desktop_config.json' 文件的 '"mcpServers"' 部分添加以下配置信息。请根据您的实际安装路径和API密钥进行修改。

"mcpServers": {
  "powerpoint": {
    "command": "uv",
    "env": {
      "TOGETHER_API_KEY": "YOUR_TOGETHER_API_KEY"  // 替换为您的TogetherAI API密钥
    },
    "args": [
      "--directory",
      "/path/to/powerpoint",  // 替换为克隆仓库的本地路径，例如："/Users/yourusername/powerpoint"
      "run",
      "powerpoint",
      "--folder-path",
      "/path/to/decks_folder" // 替换为您希望存放演示文稿的文件夹路径，例如："/Users/yourusername/decks"
    ]
  }
}

配置参数说明：

  • 'command': 启动服务器的命令，这里使用 'uv' 运行Python脚本。
  • 'env': 环境变量配置，用于设置TogetherAI API密钥。
    • 'TOGETHER_API_KEY': 您的TogetherAI API密钥，请务必替换为您的真实API密钥。
  • 'args': 传递给服务器的命令行参数。
    • '--directory': PowerPoint演示文稿服务器仓库的本地路径，请替换为实际路径。
    • 'run powerpoint': 运行 'powerpoint' 包，即执行 'src/powerpoint/init.py' 中的 'main' 函数。
    • '--folder-path': 演示文稿和图片保存的文件夹路径，请替换为您希望使用的文件夹路径。

基本使用方法

配置完成后，您的MCP客户端（如Claude Desktop）应该能够检测到PowerPoint演示文稿服务器。您可以通过自然语言指令，指示客户端调用服务器提供的工具来创建和编辑演示文稿。

使用示例 (参考仓库README.md中的例子)：

  • 创建一个关于鱼的演示文稿，创建一些图片，并包含表格和图表。
  • 创建一个关于附件论文的演示文稿，并使用以下图片： 'author.jpeg' (请确保 'author.jpeg' 图片位于您配置的 '--folder-path' 目录下)。
  • 基于2024年销售数据表，创建一个演示文稿，展示当前趋势，并适当使用表格和图表。

请参考仓库 'README.md' 和代码中的工具描述，了解每个工具的具体参数和使用方法，以便在MCP客户端中正确调用。

信息

分类

生产力应用

访问项目