讯飞智文PPT生成服务MCP Server

Instructions

根据大纲创建PPT。

使用说明：
1. 用于根据已生成的大纲创建PPT。
2. 大纲需通过create_outline或create_outline_by_doc工具生成。
3. template_id需通过get_theme_list工具获取。
4. 工具会返回任务ID(sid)，需用get_task_progress轮询查询进度。
5. 任务完成后，可从get_task_progress结果中获取PPT下载地址。
6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。

参数：
- text: PPT生成的内容描述，用于指导PPT生成。
- outline: 大纲内容，需从create_outline或create_outline_by_doc工具返回的JSON响应中提取['data']['outline']字段的值。该字段包含生成的大纲内容，格式为dict。
- template_id: PPT模板ID，需通过get_theme_list工具获取。
- author: PPT作者名称，将显示在生成的PPT中。
- is_card_note: 是否生成PPT演讲备注，True表示生成，False表示不生成。
- search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。
- is_figure: 是否自动配图，True表示自动配图，False表示不配图。
- ai_image: AI配图类型，仅在is_figure为True时生效。可选值：normal-普通配图(20%正文配图)，advanced-高级配图(50%正文配图)。

返回：
成功时返回包含sid的字典，失败时抛出异常。

Implementation Reference

• src/zwppt_mcp/server.py:267-327 (handler)

  The @mcp.tool()-decorated handler function implementing the create_ppt_by_outline tool. It constructs a request body from parameters including the outline dict, sends a POST to the xfyun API endpoint, and returns the task sid on success.

  @mcp.tool()
  def create_ppt_by_outline(
      ctx: Context,
      text: str,
      outline: dict,
      template_id: str,
      author: str = "XXXX",
      is_card_note: bool = True,
      search: bool = False,
      is_figure: bool = True,
      ai_image: str = "normal"
  ) -> Dict[str, Any]:
      """
      根据大纲创建PPT。
      
      使用说明：
      1. 用于根据已生成的大纲创建PPT。
      2. 大纲需通过create_outline或create_outline_by_doc工具生成。
      3. template_id需通过get_theme_list工具获取。
      4. 工具会返回任务ID(sid)，需用get_task_progress轮询查询进度。
      5. 任务完成后，可从get_task_progress结果中获取PPT下载地址。
      6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。
      
      参数：
      - text: PPT生成的内容描述，用于指导PPT生成。
      - outline: 大纲内容，需从create_outline或create_outline_by_doc工具返回的JSON响应中提取['data']['outline']字段的值。该字段包含生成的大纲内容，格式为dict。
      - template_id: PPT模板ID，需通过get_theme_list工具获取。
      - author: PPT作者名称，将显示在生成的PPT中。
      - is_card_note: 是否生成PPT演讲备注，True表示生成，False表示不生成。
      - search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。
      - is_figure: 是否自动配图，True表示自动配图，False表示不配图。
      - ai_image: AI配图类型，仅在is_figure为True时生效。可选值：normal-普通配图(20%正文配图)，advanced-高级配图(50%正文配图)。
      
      返回：
      成功时返回包含sid的字典，失败时抛出异常。
      """
      url = "https://zwapi.xfyun.cn/api/ppt/v2/createPptByOutline"
      headers = get_headers()
      if isinstance(outline, str):
          outline = json.loads(outline)
      body = {
          "query": text,
          "outline": outline,
          "templateId": template_id,
          "author": author,
          "isCardNote": is_card_note,
          "search": search,
          "isFigure": is_figure,
          "aiImage": ai_image
      }
      response = requests.post(url, json=body, headers=headers)
  
      if response.status_code != 200:
          raise Exception(f"调用失败: {response.text}")
      
      resp = json.loads(response.text)
      if resp['code'] == 0:
          return {"sid": resp['data']['sid']}
      else:
          raise Exception(f"根据大纲创建PPT失败: {response.text}")