PPT Generator MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 这是一个以 MCP（Model Context Protocol）为核心的后端服务，旨在为 LLM 客户端提供统一的上下文服务，包括资源管理、工具注册与执行，以及 Prompts 的渲染与应用。它通过 JSON-RPC 与客户端通信，支持多种传输模式（如 STDIO、WebSocket、SSE 等），并实现了对 PPTX 设计、脚本生成、轮廓/设计等多种后端任务的协同处理。

• 主要功能点

  • MCP 服务器核心能力
    • 资源管理：提供对资源（如 PPTX 片段、设计元素、图片等）的访问与管理。
    • 工具注册与执行：LLM 可通过工具调用外部功能，服务器注册并执行这些工具。
    • Prompt 模板定义与渲染：支持对不同任务（Outline、Script、Design、Visual QA 等）渲染相应的 Prompt 模板。
    • 会话与能力声明：服务器端负责会话管理、能力声明，以及对多传输协议的支持。
  • 多工具与服务整合
    • Outline、Script、Design、Slides、PPTX 导出/导入、Visual QA、Slides 设计等工具的 MCP 服务端实现与注册。
  • 客户端交互
    • 客户端通过 JSON-RPC 调用服务器提供的工具，如生成轮廓、生成脚本、导出 PPTX、导出 HTML、加载设计规范等。

• 安装步骤

  • 克隆代码库
  • 安装依赖（通常通过项目自带的依赖管理方式处理）
  • 启动 MCP 服务器（标准 STDIO 传输模式）
    • 运行入口通常为服务器进程，上层会用 stdin/stdout 与客户端通信。

• 服务器配置（MCP 客户端需要的配置示例） 说明：以下 JSON 配置用于 MCP 客户端在本仓库中与服务器对接的示例信息，实际使用时请将路径替换为真实的服务器目录。服务器名与启动命令与参数如下所示，客户端仅需要读取该配置以连接 MCP 服务器。

{ "server_name": "ppt-generator", "command": "uv", "args": ["--directory", "/path/to/ppt-generator", "run", "ppt-generator"], "env": { "PPT_LOG_DIR": "/tmp/ppt-generator" // 仅在需要输出本地日志时设置，可选 } }

• 基本使用方法

  • 启动服务器
    • 在支持的环境中以标准输入输出（stdio）模式启动服务器，以便 MCP 客户端通过 JSON-RPC 进行交互。
  • 常用任务示例（需通过 MCP 客户端调用）
    • 生成轮廓（Outline）：为给定主题生成 slide_outline。
    • 生成脚本（Script）：基于轮廓生成逐张幻灯片的讲稿。
    • 设计与导出（Design/Slides）：从轮廓生成设计规格，渲染并导出 HTML/PPTX。
    • 导入 PPTX（Import）：从外部 PPTX 转换为设计规格以进行编辑。
  • 日志与调试
    • 通过环境变量 PPT_LOG_DIR 或 PPT_LOG_FILE 管理日志输出。
    • MCP 服务器使用标准输出进行日志，必要时可开启文件日志以便调试。

• 运行与维护要点

  • 服务器将注册各种 MCP 工具到客户端，可按需启用/禁用工具。
  • 支持多种传输协议，具体实现包括 stdio、SSE、WebSocket 等，便于不同客户端接入。
  • 关注依赖项版本与 API 兼容性，确保客户端与服务器端在 Prompt 模板、JSON Schemas 等约定上保持一致。