PPTAgent MCP Server

使用说明(Markdown 格式)

  • 项目简介

    • 该仓库实现了一个用于 MCP 的服务端组件,允许通过 MCP 客户端以标准化的 JSON-RPC 方式读取工具、执行工具、注册模板、创建幻灯片等操作,从而把 PPT 生成与设计工作流程整合到一个统一的后端服务中。
  • 主要功能点

    • MCP 服务核心:实现一个可运行的 MCP 服务器,通过 FastMCP 提供工具接口,支持工具调用、模板管理与幻灯片生成等能力。
    • 工具注册与调用:提供若干工具,例如 将 Markdown 表格渲染为图片、列出模板、选择模板、创建幻灯片、写入幻灯片、生成幻灯片、保存生成结果等。
    • 模板与幻灯片生成:能够加载预设 PPT 模板、渲染幻灯片内容、和对外输出(如 PPTX 文件)。
    • 服务器启动与配置:核心代码可直接通过脚本启动,启动后等待 MCP 客户端接入并注册工具。
    • 与客户端的对接方式:客户端通过 MCP 协议连接服务器,获取服务器工具列表、调用工具并获取响应。
  • 安装与运行步骤

    • 确保已获取 PPTAgent 代码及依赖环境。
    • 运行 MCP 服务器(示例命令):
      • python pptagent/pptagent/mcp_server.py
    • 服务器启动后,MCP 客户端即可通过配置信息连接并使用服务器暴露的工具。
  • 服务器配置(MCP 客户端需要的配置信息,JSON 格式)

    • serverName: PPTAgent
    • description: MCP 服务器用于 PPTAgent 的资源、工具与模板的上下文服务
    • command: "python"
    • args: ["pptagent/pptagent/mcp_server.py"]
    • env: {}
    • keep_tools: null
    • exclude_tools: []

    以上配置用于 MCP 客户端在连接该服务器时需要的最低信息。配置文件示例中不会包含敏感信息,实际使用时可按需要添加环境变量或代理设置。

  • 基本使用方法

    • 启动服务器后,MCP 客户端将读取服务器的工具清单并可调用工具,例如注册、列出模板、创建幻灯片、写入幻灯片、生成幻灯片和保存输出等。
    • 使用前请确保客户端具备相应的权限和网络配置,以便与服务器进行 JSON-RPC 形式的交互。
    • 客户端调用成功后,将获得相应的返回数据(如模板信息、幻灯片内容、输出文件路径等)。
  • 其他说明

    • 该 MCP 服务器实现包含了对工具的注册、模板管理、幻灯片生成等完整流程,且具备可运行的服务器端代码,符合 MCP 的服务器实现要求。

服务器信息