A mailroom 扫描是一张图像：没有人能搜索它，文本提取器也找不到任何内容。页面上的条形码是例外。GroupDocs.Parser.Mcp 服务器在 Docker 本地运行，客户端中的 AI 代理（如 Claude Desktop、Cursor 或 GitHub Copilot）可以请求它读取扫描文档中的条形码并返回解码后的值：

读取这些扫描的送货单上的条形码，并列出它们对应的文件及其值。

逐步配置和故障排除请参见文档：如何从扫描文档中读取条形码和二维码。

为什么扫描需要条形码读取器而不是文本提取器？

扫描页没有文本层。extract_text 对其返回很少或什么也不返回，这是真实反映文件的情况。然而引擎模型能够在光栅化图像中检测代码，所以 extract_barcodes 仍然会返回扫描送货单上打印的追踪号。服务器没有 OCR 功能，打印的文字停留在像素层；只有代码会变成数据。

工具返回什么？

extract_barcodes 返回一行标题，在 … 中找到 N 条条形码，随后是一组 JSON 数组，每个对象对应一个代码，包含 index、value、type、page、confidence 和 angle。它能够识别 Code128、QR Code、PDF417、DataMatrix、EAN-13、EAN-8、UPC、Aztec 等多种符号，支持 PDF、DOCX、XLSX、PPTX、PNG、JPG、TIFF 等格式。未找到时返回 未找到条形码 消息。

示例会话（节选）：

You:    Read the barcodes on page 1 of dn-2291.pdf and tell me which order it belongs to.
Agent:  [calls extract_barcodes with page 1]
        在 dn-2291.pdf 中找到 1 条条形码
        [{"index": 1, "value": "SHP-884120377", "type": "Code128", "page": 1, "confidence": 0.98, "angle": 0}]
        The delivery note carries tracking number SHP-884120377.

如何将扫描转换为记录？

解码后的值通常是关联键：将扫描与发货关联的追踪号、将签署表单与案件关联的订单参考、将照片与库存记录关联的资产标签。代理获取该值后，图像就变成了一行记录。

对每个扫描，读取条形码并告诉我它属于哪个订单。

代理对每个文件调用 extract_barcodes，并将每个值与您提供的订单匹配。使用 page 参数仅扫描携带标签的页面，而不是长文档的每一页。

如何对混合的扫描文件和数字文件进行排序？

让代理根据文件是否有文本来分支。

对每个文件：尝试文本提取。如果返回为空，则改为读取条形码，并告诉我哪些文件需要这样做。

通过条形码读取的文件即为扫描件。如果您正在规划导入项目，这个列表本身就是有价值的清单。再添加一个路由步骤，例如“按条形码值的前缀对文件分组”，文件夹即可在到达时已经排序。

哪个服务器读取代码：Parser 还是 Signature？

两个服务器都能从扫描件读取条形码或二维码：Parser 使用 extract_barcodes，Signature 使用 search_barcodes 和 search_qr_codes。当您需要从任意扫描件中提取数据并且还需要同一文件中的文本、表格或元数据时，请使用 GroupDocs.Parser.Mcp。若代码本身是您添加的签名元素，或文档双向流转且您在输出文档上添加新代码时，请使用 GroupDocs.Signature.Mcp。Signature 方面的内容请参阅 从条形码到记录：使用 AI 代理实现文档摄取自动化。

限制有哪些？

  • 解码值是未经信任的数据。 生成文档的人自行决定其内容。请对其进行报告、查询、交叉核对，且不要让代理在未经审查的情况下直接使用。
  • 劣质扫描可能无法解码。 歪斜、低分辨率或损坏的代码可能返回空结果。空结果表示“未找到”，在糟糕的扫描中这并不等同于“不存在”。
  • 评估模式受限。 未授权时提取功能受限；请参阅库的 授权页面，并让代理先运行 get_license_status。
  • 仅限 Docker。 模型随镜像打包，这也是镜像体积大的原因。没有 dnx 命令；容器通过 docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest 启动，VS Code 和 Cursor 的一键链接位于 在 AI 客户端中注册。

FAQ

Claude 能从扫描的 PDF 中读取条形码吗？
可以，通过 extract_barcodes 工具，在本地容器中对扫描文件运行。Claude 会收到解码后的值、类型和页码。

我可以在不使用 OCR 的情况下读取扫描文档中的二维码吗？
可以。代码检测不依赖文本识别，即使页面上的打印文字无法识别，二维码仍能解码。

如何自动按条形码对扫描文档进行排序？
让代理读取每个扫描件上的代码，并按值对文件进行分组或重命名。移动文件前请先检查分组结果，因为解码值来源于文档本身。

深入了解