aippt-mcp

讯飞智文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，返回任务ID（sid）用于查询进度。
• 参数：
  • text：PPT生成的内容描述（必填）
  • template_id：PPT模板ID（必填，通过 get_theme_list 获取）
  • author：PPT作者名称（默认值：XXXX）
  • is_card_note：是否生成演讲备注（True/False，默认值：True）
  • search：是否联网搜索补充内容（True/False，默认值：False）
  • is_figure：是否自动配图（True/False，默认值：True）
  • ai_image：AI配图类型（仅在 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或本地路径上传文档（格式：pdf、doc、docx、txt、md，大小≤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。
• 参数：
  • text：PPT生成内容描述（必填）
  • outline：大纲内容（必填，需提取 create_outline 返回的 ['data']['outline'] 字段）
  • template_id：PPT模板ID（必填，通过 get_theme_list 获取）
  • author：PPT作者名称（默认值：XXXX）
  • is_card_note：是否生成演讲备注（True/False，默认值：True）
  • search：是否联网搜索补充内容（True/False，默认值：False）
  • is_figure：是否自动配图（True/False，默认值：True）
  • ai_image：AI配图类型（仅在 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 aippt-mcp

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

MCP客户端配置

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

使用uvx启动的配置（推荐）

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

说明

• 参数规格：

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

• 任务流程：

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

反馈

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