使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许用户通过与大型语言模型（LLM）交互，以自然语言指令创建和编辑 PowerPoint 演示文稿。该服务器利用 'python-pptx' 库来操作 PowerPoint 文件，并将各种演示文稿操作功能以 MCP 工具和资源的形式对外提供。

主要功能点

创建演示文稿：根据标题创建新的 PowerPoint 演示文稿。
幻灯片操作：
- 添加标题幻灯片（可包含副标题）。
- 添加内容幻灯片（带标题和项目符号列表）。
- 添加节标题幻灯片（可自定义背景色）。
- 添加图片幻灯片（支持本地文件和 URL 图片，可添加标题和描述）。
- 添加表格幻灯片（可自定义表头和数据）。
演示文稿管理：
- 保存演示文稿到指定路径。
- 生成演示文稿下载链接（Base64 编码）。
- 获取演示文稿信息（如幻灯片数量、布局）。
- 获取演示文稿大纲（文本格式）。
- 删除指定幻灯片。
- 导出整个演示文稿为 Base64 编码字符串。
错误处理和日志：提供详细的错误检查和日志输出，方便调试。

安装步骤

克隆仓库

git clone https://github.com/ltc6539/mcp-ppt.git
cd mcp-ppt

创建虚拟环境 (可选，但推荐)

python3 -m venv .venv
source .venv/bin/activate  # 或 .venv\Scripts\activate (Windows)

安装依赖

pip install -r requirements.txt

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端中配置服务器连接信息。以下是 JSON 格式的配置代码片段，您可以将其添加到客户端的配置文件中：

{
  "mcpServers": {
    "PPT Maker": { // 服务器名称，您可以自定义
      "command": "uv", // 启动命令，这里使用 'uv'，请确保已安装 uv 或替换为 'python3'
      "args": [
        "run",
        "--with",
        "mcp[cli]", // 包含 MCP 命令行工具依赖
        "--with",
        "python-pptx", // 包含 python-pptx 依赖
        "mcp", // MCP 命令
        "run", // 运行服务器
        "main.py" // 服务器脚本路径，假设您在仓库根目录下
      ]
    }
  }
}

注意:

确保您已安装 'uv'。如果未安装，可以将 'command' 和 'args' 替换为 'python3 main.py' 以直接使用 'python3' 运行。
如果需要，请根据您的实际环境调整 'main.py' 的路径。

基本使用方法

启动 MCP 服务器：根据上述配置，运行服务器启动命令。
配置 MCP 客户端：在您的 MCP 客户端（如 Claude Desktop）中添加上述服务器配置。
通过 MCP 客户端与服务器交互：您现在可以通过 MCP 客户端，使用自然语言提示调用服务器提供的工具来创建和编辑 PowerPoint 演示文稿。例如，您可以向 LLM 提出类似 “创建一个关于项目 X 的演示文稿”，“添加一个标题为 ‘介绍’ 的幻灯片，内容为...”，“保存演示文稿” 等指令。

关键词