讯飞智文PPT生成服务MCP Server

概述

讯飞智文PPT生成服务MCP Server是基于讯飞星火大模型搭建的智能文档AI助理全面兼容MCP协议支持通过MCP协议快速接入各类智能体助手如Claude``Cursor以及千帆AppBuilder等

本服务提供6个符合MCP协议标准的API接口涵盖PPT模板获取PPT生成任务创建任务进度查询大纲生成等核心功能帮助用户高效生成PPT文档提升工作与学习效率

依赖MCP Python SDK开发支持通过环境变量配置服务认证信息确保安全可靠的API调用

工具

1. 获取PPT模板列表 get_theme_list

• 描述获取可用的PPT模板列表支持通过风格颜色行业等条件筛选模板需先设置环境变量 AIPPT_APP_ID 和 AIPPT_API_SECRET
• 参数
  • pay_type模板付费类型可选值free-免费模板not_free-付费模板默认值not_free
  • style模板风格如简约商务科技等可选
  • color模板颜色如红色蓝色等可选
  • industry模板行业如教育培训金融等可选
  • page_num页码从1开始默认值2
  • page_size每页数量最大100默认值10
• 输出包含模板列表的字典每个模板包含 template_id``name``style 等信息

2. 创建PPT生成任务 create_ppt_task

• 描述根据文本内容和模板ID创建PPT生成任务需先通过 get_theme_list 获取有效的 template_id返回任务IDsid用于查询进度
• 参数
  • textPPT生成的内容描述必填
  • template_idPPT模板ID必填通过 get_theme_list 获取
  • authorPPT作者名称默认值XXXX
  • is_card_note是否生成演讲备注True/False默认值True
  • search是否联网搜索补充内容True/False默认值False
  • is_figure是否自动配图True/False默认值True
  • ai_imageAI配图类型仅在 is_figure=True 时生效可选值normal-普通配图advanced-高级配图默认值normal
• 输出成功时返回 {"sid": "任务ID"}失败时抛出异常

3. 查询PPT生成任务进度 get_task_progress

• 描述查询通过 create_ppt_task 或 create_ppt_by_outline 创建的任务进度任务完成后返回PPT下载地址
• 参数
  • sid任务ID必填从任务创建工具返回中获取
• 输出包含任务状态status和PPT下载地址download_url的字典

4. 创建PPT大纲 create_outline

• 描述根据文本内容生成PPT大纲支持联网搜索补充内容生成的大纲可用于 create_ppt_by_outline
• 参数
  • text需要生成大纲的内容描述必填
  • language大纲生成语言目前仅支持 cn-中文默认值cn
  • search是否联网搜索True/False默认值False
• 输出包含大纲内容的字典格式为 {"data": {"outline": 大纲内容}}

5. 从文档创建PPT大纲 create_outline_by_doc

• 描述根据文档内容生成PPT大纲支持通过URL或本地路径上传文档格式pdfdocdocxtxtmd大小10M字数8000字
• 参数
  • file_name文档文件名必填需包含后缀名
  • file_url文档URL地址与 file_path 二选一必填
  • file_path文档本地路径与 file_url 二选一必填
  • text补充文本内容指导大纲生成必填
  • language大纲生成语言目前仅支持 cn-中文默认值cn
  • search是否联网搜索True/False默认值False
• 输出包含大纲内容的字典格式同 create_outline

6. 根据大纲创建PPT create_ppt_by_outline

• 描述根据已生成的大纲和模板ID创建PPT需通过 create_outline 或 create_outline_by_doc 获取大纲通过 get_theme_list 获取模板ID
• 参数
  • textPPT生成内容描述必填
  • outline大纲内容必填需提取 create_outline 返回的 ['data']['outline'] 字段
  • template_idPPT模板ID必填通过 get_theme_list 获取
  • authorPPT作者名称默认值XXXX
  • is_card_note是否生成演讲备注True/False默认值True
  • search是否联网搜索补充内容True/False默认值False
  • is_figure是否自动配图True/False默认值True
  • ai_imageAI配图类型仅在 is_figure=True 时生效默认值normal
• 输出成功时返回 {"sid": "任务ID"}失败时抛出异常

开始

获取认证信息

在讯飞开放平台申请应用获取 AIPPT_APP_ID 和 AIPPT_API_SECRET并设置为环境变量

export AIPPT_APP_ID="你的应用ID"
export AIPPT_API_SECRET="你的API密钥"

Python接入

推荐方式使用uvx一键启动极简接入

uvx 是一款轻量级工具支持快速运行MCP服务无需额外安装依赖若已安装uvx可直接通过以下步骤启动服务

安装uvx首次使用需安装

# 按官方文档安装uv支持macOS/Linux/Windows
curl -fsSL https://install.astral.sh/uv | bash

启动服务

uvx zwppt-mcp

该命令会自动拉取并运行讯飞智文PPT生成服务MCP Server无需手动管理依赖或代码

MCP客户端配置

在MCP客户端如Claude.app中添加服务配置

使用uvx启动的配置推荐

{
  "mcpServers": {
    "zwppt-mcp": {
      "command": "uvx",
      "args": ["zwppt-mcp"],
      "env": {
        "AIPPT_APP_ID": "<你的应用ID>",
        "AIPPT_API_SECRET": "<你的API密钥>"
      }
    }
  }
}

说明

1. 参数规格

   • template_id 需通过 get_theme_list 工具获取确保为有效模板ID
   • sid 任务ID需从任务创建工具create_ppt_task/create_ppt_by_outline的返回中获取
   • 文档上传时file_url 与 file_path 需二选一且文件名需包含正确后缀如 .pdf/.docx

2. 任务流程

   • 生成PPT需先获取模板IDget_theme_list再创建任务create_ppt_task/create_ppt_by_outline通过 get_task_progress 轮询进度任务完成后获取下载地址

反馈

使用中遇到问题欢迎通过issue或讯飞开放平台客服反馈我们鼓励提交PR贡献代码感谢您的支持