项目简介

PowerPoint MCP Server 是一个基于 Model Context Protocol (MCP) 的应用后端,它扩展了 LLM 的能力,使其能够创建和编辑 PowerPoint 演示文稿。通过集成多种工具,该服务器允许 LLM 客户端通过标准化的 MCP 协议,操控 PowerPoint 的各项功能,例如创建演示文稿、添加各种类型的幻灯片(包括文字、图片、表格、图表等),并支持使用 Stable Diffusion 生成图像。

主要功能点

  • 创建演示文稿: 允许LLM 创建全新的 PowerPoint 演示文稿。
  • 编辑演示文稿: 支持打开已有的演示文稿进行编辑。
  • 添加各种类型的幻灯片: 包括标题页、内容页、节标题页、带表格和图表的幻灯片、以及带图片的幻灯片。
  • 图片生成: 集成 Stable Diffusion API,可以根据文本提示生成图像并插入到幻灯片中。
  • 保存演示文稿: 将编辑完成的演示文稿保存到指定文件夹。

安装步骤

  1. 安装 UV: 确保你的系统已安装 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"
  2. 克隆仓库: 使用 'git clone' 命令克隆 'powerpoint-mcp' 仓库到本地。
    git clone https://github.com/Ichigo3766/powerpoint-mcp.git
  3. 安装依赖: 导航到仓库目录,运行 'uv pip install .' 安装项目依赖。

服务器配置

要将 PowerPoint MCP 服务器与 MCP 客户端(例如 Claude)连接,您需要配置客户端的 MCP 服务器设置。以下是一个示例 JSON 配置,你需要根据你的实际环境进行调整。

{
  "mcpServers": {
    "powerpoint": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/powerpoint-mcp/src",  //  请替换为仓库src目录的绝对路径,例如 /Users/yourname/powerpoint-mcp/src
        "run",
        "powerpoint",
        "--folder-path",
        "/path/to/decks_folder" //  请替换为你希望演示文稿和图片保存的文件夹路径,例如 /Users/yourname/powerpoint_decks
      ],
      "env": {
        "SD_WEBUI_URL": "http://your-sd-webui-url:7860", //  请替换为你的 Stable Diffusion WebUI API 的 URL,例如 http://127.0.0.1:7860
        "SD_AUTH_USER": "your-username",  //  (可选) 如果你的 Stable Diffusion WebUI API 需要身份验证,请填写用户名
        "SD_AUTH_PASS": "your-password"   //  (可选) 如果你的 Stable Diffusion WebUI API 需要身份验证,请填写密码
      }
    }
  }
}

配置说明:

  • 'command': 启动服务器的命令,这里使用 'uv' 包管理器来运行 Python 脚本。
  • 'args': 传递给 'uv' 命令的参数列表,用于指定运行目录、运行的包以及服务器所需的额外参数:
    • '--directory': 指定仓库 'src' 目录的绝对路径,MCP 服务器代码位于此目录下。
    • 'run powerpoint': 指示 'uv' 运行 'powerpoint' 包,这将执行 'src/powerpoint/init.py' 文件中的 'main' 函数,从而启动 MCP 服务器。
    • '--folder-path': 指定一个文件夹路径,用于存放生成的 PowerPoint 演示文稿和图片。请根据你的需求修改此路径。
  • 'env': 环境变量配置,用于配置与 Stable Diffusion API 的连接。
    • 'SD_WEBUI_URL': Stable Diffusion WebUI API 的 URL。确保 Stable Diffusion WebUI 正在运行,并将 URL 替换为你的 WebUI 地址。
    • 'SD_AUTH_USER', 'SD_AUTH_PASS': 如果你的 Stable Diffusion WebUI API 启用了身份验证,请提供用户名和密码。如果不需要身份验证,则可以省略这两个字段。

重要: 请根据你的实际文件路径、Stable Diffusion WebUI API 地址以及是否需要身份验证,修改上述配置中的路径和参数。

基本使用方法

  1. 启动 MCP 服务器: 配置好 MCP 客户端后,启动客户端,客户端会根据配置连接到 PowerPoint MCP 服务器。
  2. 使用 LLM 客户端发送指令: 通过 LLM 客户端,使用自然语言指令指示其调用 PowerPoint MCP 服务器提供的工具。例如,你可以指示 LLM "创建一个关于太阳系的演示文稿" 或 "在演示文稿中添加一张关于火星的图片"。
  3. 查看和编辑演示文稿: LLM 客户端会调用相应的工具在服务器端创建或编辑 PowerPoint 演示文稿。你可以在配置的 'folder-path' 文件夹中找到生成的演示文稿文件,并使用 PowerPoint 软件打开查看和进一步编辑。

注意事项

  • 确保已安装 PowerPoint 软件,以便在本地查看和编辑生成的演示文稿。
  • 首次使用图片生成功能时,请确保 Stable Diffusion WebUI API 服务已正确配置并可访问。
  • 'folder-path' 指定的文件夹需要存在并且具有写入权限,以便服务器可以保存演示文稿和图片。

信息

分类

生产力应用