Laiye Adp Mcp

ADP MCP

让 AI Agent 能够原生处理业务文档。它可从发票、采购订单、合同、物流单据、财务报表及其他文件中提取结构化数据，并支持在聊天会话中直接上传文件、解析、提取数据和查询结果。

---

关于 ADP MCP 服务

Laiye Agentic Document Processing（ADP）MCP 服务

ADP MCP 服务可将企业文档转换为 AI Agent 可调用的数据。用户可以在聊天对话中直接上传发票、采购订单、合同、账单、图片、电子表格及其他文件。ADP 会自动执行内容识别、字段提取和结构化数据输出，减少人工录入、复制粘贴操作以及跨系统处理的开销。

针对真实业务场景中的复杂版式、表格明细、扫描件、多语言收据和长篇文档进行了优化，ADP MCP 服务能够提供更高的准确率和更一致的结构化输出。它为文档审核、账目核对、数据录入、文件导出和端到端业务流程自动化等下游工作流提供支持。

---

快速开始

1. 获取 API 密钥

在 https://adp-global.laiye.com/ 注册，然后在个人设置中的 My MCP 获取 API Key。

2. 配置 MCP 客户端

选项 A：可视化设置界面（推荐）

大多数 MCP 客户端（Cursor、通义灵码、Coze 等）都允许你直接在设置面板中添加 MCP 服务。以下以 Cursor 为例：

1. 打开 Settings → MCP
2. 点击 Add new MCP server
3. 填写以下内容：
   • Name：ADP（可使用任意名称）
   • Type：streamable-http
   • URL：https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>
4. 保存后，ADP 工具即可在下一次对话中使用

选项 B：编辑配置文件

对于 Claude Desktop，将以下内容添加到 claude_desktop_config.json。支持两种连接方式：

远程连接（Streamable HTTP）

{
  "mcpServers": {
    "adp": {
      "url": "https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>",
      "transport": "streamable-http"
    }
  }
}

本地命令（npx，stdio）

{
  "mcpServers": {
    "adp": {
      "command": "npx",
      "args": ["-y", "@laiye-adp/mcp"],
      "env": {
        "ADP_API_KEY": "<YOUR-ADP-API-Key>"
      }
    }
  }
}

以下参数适用于任何 MCP 客户端：

参数	值
端点	https://adp.laiye.com/mcp
传输方式	Streamable HTTP
身份验证	URL 查询参数 ?key=<YOUR-ADP-API-Key>

对于私有部署，请将域名替换为实际的服务地址。

3. 开始使用

连接后，AI 客户端会自动发现所有可用的 ADP 工具。只需用自然语言描述你的需求：

• “解析此 PDF 的结构”
• “提取此身份证件中的信息”
• “从此发票中提取金额和日期”

---

工具目录

文档解析

工具名称	标题	描述
parse_document	通用文档解析	解析 PDF、图片、Word、Excel、PPT 及其他文档，进行版面分析，并返回结构化文本块、表格、阅读顺序和页面坐标。当文档类型未知且需要原始结构以供进一步处理时使用；对于发票、身份证件或其他特定类型，建议使用专用提取工具。

发票与订单提取

工具名称	标题	描述
extract_china_invoice	中国发票 / 票据	支持 30 多种常见中国票据类型：全电发票、增值税普通发票、增值税专用发票、出租车票、火车票、航空运输电子客票行程单、财政票据等。提取发票号码、日期、金额、买方、卖方等关键字段；还支持发票真伪查验。
extract_global_invoice	全球发票 / 收据	从 PDF 或图片格式的海外发票、收据或票据中提取关键字段（发票号码、日期、金额、税额、币种、行项目等）。适用于跨境贸易、报销和应付账款自动化；对于中国增值税发票，请使用专用的中国发票工具。
extract_purchase_order	采购 / 销售订单	从 PDF 或图片格式的采购订单或销售订单中提取关键字段（订单编号、买方 / 卖方信息、订单日期、商品详情、数量、单价、总金额、收货地址等）。适用于电商订单录入、供应链对账和仓库管理自动化。

卡片与证件提取

工具名称	标题	描述
extract_id_card	中国居民身份证	从中国大陆居民身份证图像中提取关键字段（姓名、性别、民族、出生日期、身份证号码、地址、签发机关、有效期等）。支持正反两面。对于港澳台通行证或护照，请使用相应工具。
extract_bank_card	银行卡	从银行卡正面图像中提取关键字段（卡号、发卡银行、卡类型、有效期等）。仅识别卡面公开信息；不会提取 CVV 等敏感字段。
extract_vehicle_cert	车辆合格证	从车辆合格证图像中提取关键字段（证书编号、车辆品牌、型号、VIN、发动机号码、制造日期等）。适用于车辆登记、二手车交易和车队管理。
extract_account_permit	银行开户许可证	从企业银行开户许可证图像中提取关键字段（公司名称、基本账户号码、银行名称、核准号、签发日期等）。
extract_driver_license	中国机动车驾驶证	从中国机动车驾驶证图像中提取关键字段（姓名、性别、国籍、出生日期、驾驶证号码、准驾车型、初次领证日期、有效期等）。支持主页和副页。
extract_business_license	营业执照	从中国营业执照图像中提取关键字段（公司名称、统一社会信用代码、法定代表人、注册资本、成立日期、经营范围、注册地址等）。
extract_passport_cn	中国护照	从中华人民共和国护照图像中提取关键字段（中文姓名、罗马拼写姓名、性别、出生日期、护照号码、国籍、签发日期、有效期、签发机关等）。不支持外国护照。
extract_vehicle_license	机动车行驶证	从中国机动车行驶证图像中提取关键字段（车牌号码、车辆类型、所有人、VIN、发动机号码、注册日期、签发日期等）。支持主页和副页。
extract_org_code_cert	组织机构代码证	从组织机构代码证图像中提取关键字段（组织名称、组织机构代码、法定代表人、地址、签发日期、有效期等）。对于新注册企业，请改用营业执照工具。
extract_household_book	户口簿	从中国户口簿图像中提取关键字段（户号、户别、地址、家庭成员列表，包括姓名、身份证号码及与户主的关系等）。支持索引页和个人页。
extract_hk_macao_permit	港澳通行证	从往来香港、澳门特别行政区通行证图像中提取关键字段（姓名、性别、出生日期、通行证号码、签发日期、有效期、签发机关等）。

自定义提取

除了上述开箱即用的工具外，MCP 还提供两个固定工具，用于操作你在 ADP 平台上创建的自定义提取应用：

工具名称	标题	描述
list_custom_extract_apps	列出自定义提取应用	列出当前用户创建的所有自定义文档提取应用，并返回每个应用的 ID、名称、描述、标签和输出字段定义。使用此工具查找 execute_custom_extract_app 所需的 app_id。
execute_custom_extract_app	执行自定义提取应用	使用指定的自定义文档提取应用处理文件。先使用 list_custom_extract_apps 获取 app_id。

工作流： 调用 list_custom_extract_apps 浏览可用应用并获取目标 app_id，然后调用 execute_custom_extract_app 并传入 app_id 和文件以执行提取。

---

工具输入参数

文档解析与 OOTB 提取工具

所有开箱即用的工具都使用统一的输入架构：

参数	类型	必填	描述
file	string	是	文件 URL 或 Base64 编码内容
file_name	string	否	文件名（含扩展名）
with_rec_result	boolean	否	是否包含 OCR 中间结果，默认为 true
wait	boolean	否	是否同步等待结果，默认为 true
timeout_seconds	integer	否	同步等待超时时间（秒），默认为 300，范围为 1–900

execute_custom_extract_app

除上述参数外：

参数	类型	必填	描述
app_id	string	是	自定义提取应用 ID（通过 list_custom_extract_apps 获取）

list_custom_extract_apps

无需输入参数。

文件输入方式：

• URL：将以 http://、https:// 或 file:// 开头的链接作为 file 传入
• Base64：将 Base64 编码的文件内容作为 file 传入（非 URL 时自动检测）

同步与异步：

• wait=true（默认）：阻塞直到处理完成，并直接返回结果
• wait=false：立即返回 task_id，以便后续查询状态

---

工具输出

parse_document 输出

{
  "task_id": "fabd7f0a4e7211f1bbc4d85ed35661fd",
  "status": 4,
  "message": "",
  "doc_recognize_result": [
    {
      "page_num": 1,
      "document_content": "Full text content of this page...",
      "document_details": [
        {
          "type": "Text",
          "text": "Paragraph content...",
          "position": [{"points": [{"x": 311, "y": 50}, {"x": 500, "y": 50}, {"x": 500, "y": 80}, {"x": 311, "y": 80}]}],
          "ocr_confidence": {
            "ocr_mean_confidence": 0.999,
            "ocr_min_confidence": 0.998,
            "is_overall_confidence": 1
          }
        },
        {
          "type": "Table",
          "text": "Column A\tColumn B\nValue 1\tValue 2",
          "position": [{"points": [...]}],
          "ocr_confidence": {...}
        },
        {
          "type": "Picture",
          "text": "https://adp.laiye.com/web/.../file/abc123",
          "position": [{"points": [...]}],
          "ocr_confidence": {...}
        }
      ]
    }
  ]
}

字段	类型	描述
task_id	string	任务 ID
status	integer	任务状态码
message	string	状态消息
doc_recognize_result	array	每页的识别结果
doc_recognize_result[].page_num	integer	页码（从 1 开始）
doc_recognize_result[].document_content	string	按阅读顺序排列的页面全文
doc_recognize_result[].document_details	array	元素级详情
document_details[].type	string	元素类型：Text、Table 或 Picture
document_details[].text	string	文本内容；若为 Picture 类型，则为图片 URL
document_details[].position	array	边界框坐标（4 个角点）
document_details[].ocr_confidence.ocr_mean_confidence	float	OCR 平均置信度（0–1）
document_details[].ocr_confidence.ocr_min_confidence	float	OCR 最低置信度（0–1）

提取工具输出

{
  "task_id": "91283e544e7111f18cd6d85ed35661fd",
  "status": 4,
  "message": "",
  "extraction_result": [
    {
      "field_key": "invoice_number",
      "field_name": "Invoice Number",
      "field_values": [
        {
          "field_value": "24VLT0591617",
          "field_confidence": 1.0,
          "references": []
        }
      ]
    },
    {
      "field_key": "line_items",
      "field_name": "Product Details",
      "references": [],
      "field_confidence": 1.0,
      "table_values": [
        [
          {
            "field_name": "Description",
            "field_key": "line_items_description",
            "field_values": [
              {
                "field_value": "TESLA MODEL 3",
                "field_confidence": 1.0,
                "references": "Description: TESLA MODEL 3"
              }
            ]
          }
        ]
      ]
    }
  ]
}

常规字段（无 table_values）：

字段	类型	描述
field_key	string	机器可读的字段标识符
field_name	string	人类可读的字段名称
field_values	array	提取的值
field_values[].field_value	string	提取的值
field_values[].field_confidence	float	置信度分数（0–1）

表格字段（有 table_values）：

字段	类型	描述
field_key	string	表格标识符
field_name	string	表格名称
table_values	array[array]	二维数组：由单元格行组成，每个单元格包含 field_name、field_key、field_values

**区分方法：**字段对象包含 table_values → 表格字段；仅包含 field_values → 常规字段。

异步响应（wait=false）

{
  "task_id": "fabd7f0a4e7211f1bbc4d85ed35661fd",
  "status": "running"
}

---

任务状态码

状态码	MCP 状态	描述
0	running	未知
1	running	就绪 / 已排队
2	running	处理中
4	success	成功
5	failed	失败
6	failed	已取消

---

支持的文件格式

格式	扩展名	备注
PDF	.pdf	支持扫描件和电子文档
图像	.jpg .jpeg .png .bmp .tiff .webp	支持相机拍摄的照片
Word	.doc .docx	-
Excel	.xls .xlsx	-
PPT	.ppt .pptx	-

---

身份验证

ADP MCP Server 使用 API Key 身份验证，通过 URL 查询参数传递：

https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>

• API Key 可在 ADP 控制台的 My MCP 页面获取
• 每个 API Key 绑定到单个用户，只能访问该用户的应用和数据
• API Key 不会出现在请求正文或响应中

---

常见问题

问：连接后，某些卡片/证书工具没有显示？

答：工具列表会根据已初始化的应用动态生成。首次连接时，系统会自动初始化所有开箱即用的应用。初始化完成后，刷新工具列表即可查看所有可用工具。

问：卡片工具返回“提取失败”？

答：请确保上传的文件与工具类型相匹配（例如，身份证图片应使用 extract_id_card，而不是 extract_vehicle_cert）。文件必须为支持的图像或 PDF 格式。

问：如何处理超时？

答：默认超时时间为 300 秒（5 分钟）。你可以通过 timeout_seconds 参数调整（最长 900 秒）。对于大型文件或复杂文档，请使用 wait=false 启用异步模式，之后再使用 task_id 查询结果。

问：MCP 与 ADP CLI / OpenAPI 有何区别？

答：三者提供的功能相当，区别在于集成方式：

方式	适用场景
MCP Server	AI 客户端（Claude Desktop、Cursor 等）——无需编写代码
ADP CLI	终端、脚本、AI Skill 集成
OpenAPI	业务系统集成、后端服务调用

---

许可证

• MCP Server：免费连接，作为 ADP 平台的一部分提供
• ADP Service：基于云的 AI 文档处理服务，按使用量计费

免费套餐：新用户注册后每月可获得 100 个免费额度

立即开始

---

支持与联系

• API 文档： Open API Guide
• 产品手册： Cloud Operations Manual
• 电子邮箱： [email protected]
• 网站： Laiye