mcpField
D
DocuPipe

DocuPipe

本地服务
docupipe.ai生产力12 天前更新
代码仓库访问官网

关于 DocuPipe

DocuPipe 是供 MCP 客户端调用的文档处理服务，可从文件或 URL 提取结构化 JSON，并保存结果。它提供模式复用、文档分类、拆分及工作流等操作。

主要功能

  1. 01从文件或 URL 提取结构化 JSON
  2. 02创建和复用 JSON Schema
  3. 03分类并拆分文档
  4. 04运行已保存的工作流
  5. 05将文档转换为 Excel
  6. 06查看文档状态和提取结果

适用场景

  1. 01从发票 PDF 提取编号、日期和明细
  2. 02批量处理文档并保存 JSON
  3. 03按类别整理上传的文档
  4. 04将文档转换为本地 Excel 工作簿

MCP 相关

DocuPipe 提供 MCP 服务，供 Claude Code、Codex、Cursor 等 MCP 客户端调用文档上传、提取、分类和转换工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "docupipe-docupipe": {
      "command": "npx",
      "args": [
        "-y",
        "@docupipe/mcp"
      ],
      "env": {
        "DOCUPIPE_API_KEY": "<DOCUPIPE_API_KEY>",
        "DOCUPIPE_BASE_URL": "<DOCUPIPE_BASE_URL>"
      }
    }
  }
}
启动命令npx -y @docupipe/mcp
需要配置的环境变量
DOCUPIPE_API_KEY密钥Your DocuPipe API key, from the Developers card on the Settings page.
DOCUPIPE_BASE_URLOverrides the API address. Defaults to https://app.docupipe.ai.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@docupipe/mcp0.1.0

工具

16

收录的工具列表 · 更新于 1 天前

参数类型必填说明
urlstring否要上传文件的公共 URL，替代 file_path。
save_tostring否可选路径，用于将提取出的 JSON 写入相对于工作目录的位置。
citationsboolean否将每个值引用到其在页面上的位置（边界框和置信度）。使用标准处理，每页 3 点。
file_pathstring否要上传的本地文件，相对于工作目录。
schema_idstring否要通过 list_schemas 提取时使用的已保存架构。
guidelinesstring否自然语言提取说明。没有架构时，这些说明也会影响起草的架构。
document_idstring否已上传的文档，用于替代重新上传。
json_schemaobject否内联 JSON Schema（类型为 object，每个属性都带有描述）。先另存为新架构，免费。
schema_namestring否从 json_schema 创建的架构名称。
effort_levelenum否提取力度。'standard'（默认）适用于大多数文档；只有在标准模式遗漏或误读值后，才使用 'high'。standard | high
upload_job_idstring否恢复处理时，document_id 对应的上传任务。
standardization_idstring否恢复：已启动的提取任务。需要 standardization_job_id。
include_field_metadataboolean否同时返回每个字段的页码；有引用时，还返回边界框和置信度。
standardization_job_idstring否恢复：standardization_id 对应的任务。

详细介绍

DocuPipe MCP 服务

在 Claude Code、Codex、Cursor 和其他 MCP 客户端中使用 DocuPipe。让你的 Agent“从这些发票中提取行项目”，它就会上传文件、提取你指定的字段并保存为 JSON，每个文件只需调用一次工具。

设置

  1. 注册，并从 Settings 页面上的 Developers 卡片中复制 API 密钥。
  2. 将服务添加到你的客户端，并替换 your-api-key。需要 Node.js 18 或更高版本。

Claude Code

claude mcp add docupipe --scope user -e DOCUPIPE_API_KEY=your-api-key -- npx -y @docupipe/mcp

Codex

codex mcp add docupipe --env DOCUPIPE_API_KEY=your-api-key -- npx -y @docupipe/mcp

Cursor：打开此链接进行安装，然后在 Cursor 的 MCP 设置中替换 your-api-key：

cursor://anysphere.cursor-deeplink/mcp/install?name=docupipe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkb2N1cGlwZS9tY3AiXSwiZW52Ijp7IkRPQ1VQSVBFX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkifX0=

也可以手动添加。适用于使用 mcp.json 文件的 Cursor 和其他客户端：

{
  "mcpServers": {
    "docupipe": {
      "command": "npx",
      "args": ["-y", "@docupipe/mcp"],
      "env": { "DOCUPIPE_API_KEY": "your-api-key" }
    }
  }
}

然后可以这样提问：

使用 DocuPipe 从 ./invoices 中的每个 PDF 提取发票编号、日期、供应商和行项目，并为每张发票保存一个 JSON 文件。

工具

工具功能
extract输入文件或 URL，输出结构化 JSON：上传文件，使用已保存的架构、内联 JSON Schema 或 DocuPipe 起草的架构进行提取，等待处理，并可保存结果
upload_document上传本地文件或 URL，并等待文件读取完成
get_document获取文档状态、页数和解析后的文本
standardize从已上传的文档中提取内容
get_standardization获取提取结果
create_schema, list_schemas保存 JSON Schema，或复用账户中已有的架构
list_classes, classify将文档分类到账户中的类别
split_document将文件拆分为多个子文档，由 AI 判断每个子文档的起始位置
list_workflows, run_workflow对文件运行已保存的工作流
convert_to_excel, get_excel_conversion无需架构即可将文档转换为 .xlsx 工作簿，并保存到本地
get_job, wait_for_jobs检查或等待任意任务

每次调用约 45 秒内返回。如果 DocuPipe 需要更长时间，工具会返回 status: "processing"，并附上目前已创建的所有 ID 以及恢复处理所需的准确调用方式。恢复处理不会再次上传或提取。

积分

工具会使用 DocuPipe 账户中的积分。PDF、图像、Word 和 HTML 文件的上传费用为每页 1 个积分（CSV、Excel、JSON、文本和 XML 文件可免费上传）。标准强度的提取费用为每页 2 个积分，高强度则为每页 4 个积分。各项操作的费用请参阅积分与账单。

配置

变量
DOCUPIPE_API_KEY必填。你的 API 密钥。
DOCUPIPE_BASE_URL可选。覆盖 API 地址。默认值为 https://app.docupipe.ai。

相对文件路径以服务启动时所在的目录为基准；对于大多数客户端，这就是你的项目文件夹。支持最大 100 MB 的本地文件；更大的文件请传入 URL。超过约 40,000 个字符的结果会写入该文件夹中的 docupipe-results/，工具会返回文件路径及预览。

链接

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。