Appearance
✨ ChatPPT MCP Server 工具与调用指南
ChatPPT 提供全流程的智能文档生成与编辑能力，支持从 PPT 创建、编辑、美化、演讲稿生成、模板替换、主题设置，到下载与分享 的完整链路。 同时，文档中列举了典型的智能体配置方案，帮助开发者和企业快速接入和使用。
🔧 工具一览表
🔍 query_ppt - 查询PPT生成进度
功能简述
根据PPT任务ID查询异步生成结果，status=1表示生成中，status=2表示成功，status=3表示失败；成功后可调用download_ppt下载PPT或editor_ppt生成编辑器地址。
输入参数
- ppt_id (string): PPT-ID
📝 build_ppt - 生成PPT
功能简述
根据主题生成PPT。当返回PPT-ID时表示生成任务成功，可调用query_ppt工具查询生成进度。
输入参数
- theme (string): 描述生成主题
- ppt_complex (integer): PPT复杂度（1=简单，2=中等，3=复杂）
- font_name (string): 字体名称（黑体、宋体、仿宋、幼圆、楷书、隶书）
- language (string): 语言（zh-CN、en-US、zh-TW）
- color (string): PPT模板主题色（紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色）
- user_name (string): 作者名称
📖 text_build_ppt - 根据长文本生成PPT
功能简述
根据长文本（50字以上）生成PPT。当返回PPT-ID时表示生成任务成功，可调用query_ppt工具查询生成进度。
输入参数
- text (string): 输入描述的文本（50字以上）或Markdown
📁 build_ppt_by_file - 文件生成PPT
功能简述
根据用户上传的文件生成PPT任务，支持Markdown、Word、PDF、XMind、FreeMind、TXT等文档文件。返回PPT-ID后可查询生成进度。
输入参数
- file_url (string): 文件地址
🎓 build_thesis_ppt - 论文文件生成答辩PPT
功能简述
根据上传的论文文件（PDF/Word）生成答辩PPT。返回PPT-ID后可查询生成进度。
输入参数
- file_url (string): 论文文件地址
💾 download_ppt - 下载PPT
功能简述
当PPT生成完成后，获取完整PPT文件下载地址，方便本地下载。
输入参数
- ppt_id (string): PPT-ID
🖥 editor_ppt - 在线编辑PPT
功能简述
基于生成后的文件，生成PPT编辑器URL，方便在线编辑和浏览。
输入参数
- ppt_id (string): PPT-ID
🎨 ppt_replace_template - 替换PPT模板
功能简述
根据任务PPT-ID执行随机替换模板，返回新的PPT-ID，可查询生成进度。
输入参数
- ppt_id (string): PPT-ID
🎨 ppt_set_color - 设置PPT主题色
功能简述
根据PPT-ID设置或更换主题色，返回新的PPT-ID，可查询生成进度。
输入参数
- ppt_id (string): PPT-ID
- color (string): PPT主题色（可使用颜色名或RGB值）
✍ ppt_set_font_name - 设置PPT字体
功能简述
根据PPT-ID设置字体，返回新的PPT-ID，可查询生成进度。
输入参数
- ppt_id (string): PPT-ID
- font_name (string): 字体名称
🎬 ppt_set_anim - 设置PPT动画
功能简述
根据PPT-ID设置或取消动画效果，返回新的PPT-ID，可查询生成进度。
输入参数
- ppt_id (string): PPT-ID
- set_anim (string): 是否设置动画（1=设置，0=取消）
📝 ppt_create_note - 生成演讲稿
功能简述
根据PPT-ID自动生成完整演讲稿，返回新的PPT-ID。
输入参数
- ppt_id (string): PPT-ID
➕ ppt_add_slides - 插入幻灯片
功能简述
在生成后的PPT中插入或新增幻灯片，返回新的PPT-ID。
输入参数
- ppt_id (string): PPT-ID
- slide_text (string): 插入页文本
- slide_type (string): 页面类型（封面页、目录页、章节页、内容页、致谢页）
🗂 ppt_create_outline_text - 生成大纲内容
功能简述
根据用户输入文本生成大纲内容，直接返回大纲文本。
输入参数
- ppt_text (string): 用户输入的文本
🖼 ppt_create_template_cover_image - 生成模板封面图
功能简述
根据用户输入文本生成模板封面图，返回模板ID，可指定颜色、风格及数量。
输入参数
- ppt_text (string): 用户输入文本
- ppt_color (array): 模板颜色，可选
- ppt_style (string): 模板风格，可选
- ppt_num (integer): 模板数量，默认4
🎨 ppt_replace_user_select_template - 替换指定模板
功能简述
通过Cover-ID替换指定模板，返回新的PPT-ID。
输入参数
- ppt_id (string): PPT-ID
- cover_id (string): 模板ID
🏢 company_build_ppt - 企业PPT生成
功能简述
根据主题生成企业PPT，可设置公司名称、AI图片、模板地址等参数，返回PPT-ID。
输入参数
- text (string): 描述生成主题
- ppt_complex (integer): PPT复杂度（1=简单，2=中等，3=复杂）
- font_name (string): 字体名称
- language (string): 语言
- color (string): PPT主题色
- user_name (string): 作者名称
- company (string): 公司名称
- ai_picture (boolean): 是否使用AI图片
- template_url (string): 模板地址
📌 调用流程
典型调用链路：
lua
build_ppt / text_build_ppt / build_ppt_by_file / company_build_ppt / build_thesis_ppt
│
▼
query_ppt ── status=1 → 继续轮询
│
├─ status=2 → [download_ppt / editor_ppt / 后续增强操作]
└─ status=3 → 失败，提示用户说明： 所有 生成类工具 必须经过 query_ppt 查询任务状态。 当状态为完成（status=2）后，可以进入下载、编辑或调用美化增强类工具。 当状态为失败（status=3），需终止流程并提示用户。