AI导哈

文档转换与生成API

Iteration Layer API提供文档转换、提取、生成及图像处理功能，适用于发票处理、内容重组和产品目录处理等多种场景。

  • by iterationlayer
  • 云端部署
  • 更新于
在 GitHub 查看 iterationlayer/mcp

使用说明

迭代层API包括内置的 模型上下文协议（MCP） 服务器。MCP允许Claude Desktop、Cursor和Windsurf等人工智能代理直接调用API作为工具，无需自定义集成代码。

服务器终结点

MCP服务器可通过Streamable HTTP传输访问：

https://api.iterationlayer.com/mcp

认证

MCP端点使用 OAuth 2.1 -而不是API密钥。您的MCP客户端会自动处理身份验证流程。当您首次使用迭代层工具时，将打开一个浏览器窗口供您登录和授权访问。

可用工具

MCP服务器为每个迭代层API公开一个工具：

convert_document_to_markdown

转换文档或图像以清除标记。支持PDF、DOCX、XLSX、图像（PNG、JPG、GIF、WebP）、HTML、Markdown、CSV、JSON和纯文本。

参数：

  • file （必填）--文件输入 type, name，或者 base64 或 url

看 文档到Markdown 以获取API的完整参考。

提取文档

使用AI从文档中提取结构化数据。支持PDF、DOCX、图像（PNG、JPG、GIF、WebP）和文本文件（MD、TXT、CSV、JSON）。

参数：

  • files （必填）--文件输入数组（每个都有 type, name，或者 base64 或 url)
  • schema （必需）--带有 fields 定义提取内容的数组

看 文档提取 获取完整的模式参考。

提取网站

使用与文档提取相同的提取模式系统从一个公共网站页面提取结构化数据。

参数：

  • file （必填）--网站URL输入 type: "url", url，可选 name，可选 fetch_options
  • schema （必需）--带有 fields 定义提取内容的数组
{
  "file": {
    "type": "url",
    "url": "https://example.com/pricing"
  },
  "schema": {
    "fields": [
      {
        "name": "plan_name",
        "type": "TEXT",
        "description": "The name of the pricing plan"
      }
    ]
  }
}

看 网站提取 获取完整的模式参考。

transform_image

转换和操纵图像。支持的操作：调整大小、裁剪、延伸、修剪、旋转、翻转、翻转、模糊、锐化、调制、着色、灰度、反转颜色、自动对比度、伽玛、移除透明度、阈值、去噪、不透明度、转换、升级、smartCrop、压缩ToSize、移除背景。

参数：

  • file （必填）--文件输入 type, name，或者 base64 或 url
  • operations （必需）--按顺序应用的转换操作数组

看 图像变换 以获取完整的操作参考。

generate_image

从图层合成生成图像。图层类型：纯色、渐变、文本（带Markdown粗体/斜体）、图像、二维码、条形码和布局（带方向、间隙、对齐和填充的嵌套柔性容器）。图层按索引顺序合成，每层不透明度和旋转。

看 图像生成 对于完整的构图模式。

生成文档

从结构化定义生成PDF、DOCX、PPTX或EPUB文档。文档由元数据、页面设置、样式和内容块（段落、标题、图像、表格、网格、列表、目录、分页符、分隔符、二维码、条形码）组成。

看 文档生成 对于完整的文档架构。

generate_weet

从结构化表格数据生成XLSX、CSV或Markdown电子表格。使用可选格式（货币、百分比、数字、小数、日期、日期时间、时间、自定义）、单元格样式、合并单元格跨度和Excel公式定义单元格的列和位置行。支持多张纸、ISO 4217货币代码和自定义字体。

看 工作表生成 获取完整的模式参考。

客户端设置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "iterationlayer": {
      "type": "http",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

光标

添加到您的 .cursor/mcp.json:

{
  "mcpServers": {
    "iterationlayer": {
      "type": "http",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

帆板运动

添加到您的Windsurf MCP配置中：

{
  "mcpServers": {
    "iterationlayer": {
      "type": "http",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

输入和输出格式如何工作

每个工具都遵循相同的文件输入约定：

{
  "type": "url",
  "name": "document.pdf",
  "url": "https://example.com/document.pdf"
}

或者对于内联内容：

{
  "type": "base64",
  "name": "document.pdf",
  "base64": "JVBERi0xLjQK..."
}

每个产生二进制输出（图像、文档、电子表格）的工具都返回相同的结构：

{
  "buffer": "base64-encoded-content",
  "mime_type": "application/pdf"
}

这种一致性对可组合性很重要。输出格式 generate_image 匹配的输入格式 generate_document的图像块。代理不需要在格式之间转换或理解特定于格式的编码。

可组合性模式

所有工具共享一个端点、相同的身份验证、相同的信用池和兼容的I/O格式。这使得多步骤代理工作流变得自然。

对于生产工作流程，在应用程序逻辑中明确信心、审查和审计决策。代理人可以致电 extract_document，但在生成工件、更新记录或发送面向客户的输出之前，您的工作流仍应屏蔽低置信度或高影响的字段。看 工作流设计最佳实践 用于信心门、审查分支、审计记录、批准值、保留边界和数据流行为。

摘录和报告

从文档中提取结构化数据，然后根据提取的数据生成报告。

流量： extract_document → 应用逻辑→ generate_document

提取返回结构化JSON。文档生成接受结构化JSON。没有格式转换，没有中间文件。代理读取提取结果，从中构建文档定义，并生成输出。

转换、提取和生成

当需要将文档理解为一个整体时，首先将其转换为markdown，然后提取特定数据，然后生成输出。

流量： convert_document_to_markdown → extract_document → generate_document 或 generate_sheet

markdown转换为代理提供了上下文的完整文档文本。提取提取特定的结构化字段。当代理需要（从标记中）总结内容并（从提取中）提取精确值时，这种模式效果很好。

提取、转换和合成

将文档数据与处理后的图像相结合，以创建视觉输出。

流量： extract_document → transform_image → generate_image

提取提供了数据（产品名称、价格、描述）。图像转换准备视觉资源（调整大小、去除背景、格式转换）。图像生成将所有内容合成为最终的视觉效果。

批量提取到电子表格

处理多个文档并将结果汇总到一个电子表格中。

流量： extract_document （多次通话）→ generate_sheet

每次提取都会返回一个文档的结构化数据。代理收集结果并生成每个文档一行的电子表格。置信度得分可以作为一列进行过滤。

代理用例

发票处理流程

代理从供应商发票中提取供应商名称、发票号码、行项目、总计和付款条件。它评估置信度得分，为已批准的发票生成PDF摘要，为标记的发票生成审查报告，然后将批次导出到XLSX电子表格进行会计处理。

使用的工具： extract_document → 置信度路由→ generate_document （总结或回顾）→ generate_sheet （批量出口）

内容再利用

代理将长格式PDF白皮书转换为markdown，提取标题、作者、关键要点和统计数据，生成带有标题和品牌渐变的社交卡图像，并生成一页PDF执行摘要。

使用的工具： convert_document_to_markdown → extract_document → generate_image （社交卡）→ generate_document （摘要）

产品目录处理

代理从供应商目录PDF中提取产品名称、描述、价格和SKU。它拍摄每张产品照片，删除背景，调整到市场所需的尺寸，并转换为WebP。然后，它生成具有标准化布局的产品卡图像。

使用的工具： extract_document → transform_image （每件产品）→ generate_image （每件产品）

合同评审准备

代理将合同转换为markdown进行全文审查，提取结构化数据（各方、生效日期、终止条款、付款条款、适用法律），并生成一份审查清单作为DOCX，其中提取的条款已预先填写，审查人注释字段为空。

使用的工具： convert_document_to_markdown → extract_document → generate_document

MCP工具如何映射到SDK方法

MCP非常适合交互式代理工作流——Claude代码会话、游标对话、即席处理任务。对于生产管道，同样的工具可以通过TypeScript、Python和Go SDK获得。

MCP工具 TypeScript Python Go
convert_document_to_markdown client.convertDocumentToMarkdown() client.convert_document_to_markdown() client.ConvertDocumentToMarkdown()
extract_document client.extractDocument() client.extractDocument() client.ExtractDocument()
extract_website client.extractWebsite() client.extract_website() client.ExtractWebsite()
transform_image client.transformImage() client.transformImage() client.TransformImage()
generate_image client.generateImage() client.generate_image() client.GenerateImage()
generate_document client.generateDocument() client.generate_document() client.GenerateDocument()
generate_sheet client.generateSheet() client.generate_sheet() client.GenerateSheet()

每个方法都有一个异步变量，接受 webhook_url 对于非阻塞处理：

TypeScript Python Go
client.extractDocumentAsync() client.extract_document_async() client.ExtractDocumentAsync()
client.extractWebsiteAsync() client.extract_website_async() client.ExtractWebsiteAsync()
client.transformImageAsync() client.transform_image_async() client.TransformImageAsync()
client.generateImageAsync() client.generate_image_async() client.GenerateImageAsync()
client.generateDocumentAsync() client.generate_document_async() client.GenerateDocumentAsync()
client.generateSheetAsync() client.generate_sheet_async() client.GenerateSheetAsync()

MCP和SDK之间的参数、请求形状和响应形状是相同的。通过MCP在Claude Code中原型化的工作流通过SDK直接转换为生产代码。

列表

在以下目录中查找迭代层MCP服务器：

计费

MCP工具调用使用信用的方式与直接API调用相同。看 积分和定价 了解详情。

相关 MCP