A mailroom scan 是一張影像：沒有人能搜尋它，文字提取器也找不到任何內容。頁面上的條碼是例外。GroupDocs.Parser.Mcp 伺服器在 Docker 本機執行，AI 代理（如 Claude Desktop、Cursor 或 GitHub Copilot）可以請它從掃描文件中讀取條碼並回傳解碼後的值：

讀取這些掃描的送貨單上的條碼，並列出它們所屬的檔案及其值。

步驟說明（含設定與除錯）請參考文件：How to read barcodes and QR codes from scanned documents.

為什麼掃描需要條碼閱讀器而不是文字提取器？

掃描的頁面沒有文字層。extract_text 會回傳很少或什麼都沒有，這是檔案的真實狀況。然而引擎模型會在點陣圖中偵測到條碼，所以 extract_barcodes 仍能回傳掃描送貨單上印刷的追蹤號碼。伺服器沒有 OCR 功能，印刷的文字只剩像素；只有條碼會變成資料。

工具會返回什麼？

extract_barcodes 會先回傳標題列 Found N barcode(s) in ...，接著是一個 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 以及其他格式。若未找到條碼，則回傳「No barcodes found」訊息。

範例會話（節錄）：

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]
        Found 1 barcode(s) in dn-2291.pdf
        [{"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？

兩個伺服器都能從掃描件讀取條碼或 QR 代碼：Parser 使用 extract_barcodes，Signature 使用 search_barcodes 與 search_qr_codes。當您需要從任意掃描件提取資料，同時還需要文字、表格或中繼資料時，請使用 GroupDocs.Parser.Mcp。當條碼是您自行加入的簽章元素，或文件雙向流動且您要在輸出文件上簽署新代碼時，請使用 GroupDocs.Signature.Mcp。Signature 相關內容請參閱 從條碼到記錄：使用 AI 代理的文件接收自動化。

限制是什麼？

  • 解碼後的值屬於不可信資料。 產生文件的人自行決定內容。請先報告、查詢、交叉核對，且不要讓代理在未審核的情況下直接採取行動。
  • 掃描品質差可能無法解碼。 歪斜、低解析度或受損的條碼可能返回空結果。空結果表示「未找到」，在劣質掃描時不等同於「不存在」。
  • 評估模式受限。 未取得授權時，提取功能會受限；請參閱函式庫的 licensing page 並先讓代理執行 get_license_status。
  • 僅支援 Docker。 模型已打包於映像檔中，故映像檔較大。沒有 dnx 指令；容器以 docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest 啟動，VS Code 與 Cursor 的一鍵連結可在 Register in AI clients 中取得。

常見問題

Claude 能從掃描的 PDF 讀取條碼嗎？
可以，透過 extract_barcodes 工具在本機容器中對掃描檔執行。Claude 會收到解碼後的值、類型與頁碼。

我可以在沒有 OCR 的情況下讀取掃描文件中的 QR 代碼嗎？
可以。條碼偵測不依賴文字辨識，即使頁面上的印刷文字無法辨識，QR 代碼仍能解碼。

我如何自動依條碼對掃描文件進行排序？
請讓代理讀取每個掃描的條碼，並依條碼值對檔案進行分組或重新命名。搬移檔案前先檢查分組結果，因為解碼值直接來源於文件本身。

深入了解