讯飞智文PPT生成服务MCP Server

Instructions

从文档创建PPT大纲。

使用说明：
1. 用于根据文档内容生成PPT大纲。
2. 支持通过file_url或file_path上传文档。
3. 文档格式支持：pdf(不支持扫描件)、doc、docx、txt、md。
4. 文档大小限制：10M以内，字数限制8000字以内。
5. 生成的大纲可用于create_ppt_by_outline工具。
6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。

参数：
- file_name: 文档文件名，必须包含文件后缀名。
- file_url: 文档文件的URL地址，与file_path二选一必填。
- file_path: 文档文件的本地路径，与file_url二选一必填。
- text: 补充的文本内容，用于指导大纲生成。
- language: 大纲生成的语言，目前支持cn(中文)。
- search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。

返回：
包含生成的大纲内容的字典。

Implementation Reference

• src/zwppt_mcp/server.py:215-265 (handler)

  The handler function for the 'create_outline_by_doc' tool. It constructs a multipart form data request to the xfyun API endpoint to generate a PPT outline from a provided document (via URL or local path), with optional text guidance, language, and search settings. The @mcp.tool() decorator registers it as an MCP tool, and parameters define the input schema.

  @mcp.tool()
  def create_outline_by_doc(
      ctx: Context,
      file_name: str,
      text: str,
      file_url: Optional[str] = None,
      file_path: Optional[str] = None,
      language: str = "cn",
      search: bool = False
  ) -> Dict[str, Any]:
      """
      从文档创建PPT大纲。
      
      使用说明：
      1. 用于根据文档内容生成PPT大纲。
      2. 支持通过file_url或file_path上传文档。
      3. 文档格式支持：pdf(不支持扫描件)、doc、docx、txt、md。
      4. 文档大小限制：10M以内，字数限制8000字以内。
      5. 生成的大纲可用于create_ppt_by_outline工具。
      6. 需先设置环境变量AIPPT_APP_ID和AIPPT_API_SECRET。
      
      参数：
      - file_name: 文档文件名，必须包含文件后缀名。
      - file_url: 文档文件的URL地址，与file_path二选一必填。
      - file_path: 文档文件的本地路径，与file_url二选一必填。
      - text: 补充的文本内容，用于指导大纲生成。
      - language: 大纲生成的语言，目前支持cn(中文)。
      - search: 是否联网搜索，True表示联网搜索补充内容，False表示不联网。
      
      返回：
      包含生成的大纲内容的字典。
      """
      url = "https://zwapi.xfyun.cn/api/ppt/v2/createOutlineByDoc"
      fields = {
          "fileName": file_name,
          "query": text,
          "language": language,
          "search": str(search)
      }
      if file_url:
          fields["fileUrl"] = file_url
      elif file_path:
          fields["file"] = (file_name, open(file_path, 'rb'), 'text/plain')
      form_data = MultipartEncoder(fields=fields)
      headers = get_headers(form_data.content_type)
      response = requests.post(url, data=form_data, headers=headers)
  
      if response.status_code != 200:
          raise Exception(f"调用失败: {response.text}")
      
      return response.text