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 的服务器实现要求。