An AI 代理不應該直接讀取表格。它應該呼叫一個返回表格的工具,然後對行進行算術運算。使用在 Docker 本機執行的 GroupDocs.Parser.Mcp,像 Claude Desktop 或 Cursor 這樣的 AI 客戶端可以從 PDF、Word 和 Excel 檔案中提取表格,並以 JSON 形式接收它們:

將 invoice.pdf 中的明細項目提取為 JSON,並計算金額欄位的總和。

包含設定與故障排除的逐步說明位於文件中:如何將文件中的表格提取為結構化資料.

模型自行讀取表格時會出什麼問題?

常見的工作流程是將 PDF 貼到聊天中,並請求表格。模型看到的是一段扁平化的文字流,推斷出欄位位置,然後把行寫回。每個儲存格都是一次預測。遺失的欄位、合併的列或小數點偏移不會產生錯誤;它會產生一個自信且格式良好的表格,只是稍有錯誤。對於水果清單而言這無關緊要;但對於發票總額則影響重大。

這種失敗很難被發現,因為輸出看起來正確。聊天回覆中沒有任何資訊告訴你哪些儲存格是從檔案中讀取的,哪些是重新構造的。

有什麼替代方案可以避免讓模型猜測?

將讀取工作從模型中移除。extract_tables 工具使用文件引擎偵測表格,並以資料形式返回:

  • 預設為 Markdown,以 ### Table N (page N, R×C) 章節呈現,可直接在聊天、VS Code 與 GitHub 中渲染。
  • JSON(使用 format: "json"),以 { table, page, rows, columns, data } 物件陣列形式返回,其中 data 為字串格子。

模型永遠不會轉錄儲存格。它接收 data 並以此工作,因此其任務縮減為它可靠能執行的操作:加總、比較、篩選與說明。此工具支援 PDF、DOCX、XLSX、PPTX 與 HTML,因此相同的提示可涵蓋供應商發票、Word 報告與試算表。

如何以 JSON 取得表格?

在提示中說明所需格式。

將明細項目提取為 JSON,並計算金額欄位的總和。

Example session (abridged)
You:    Extract the line items from invoice-014.pdf as JSON and total the amount column.
Agent:  [calls extract_tables with format "json"]
        {"table": 1, "page": 1, "rows": 4, "columns": 3,
         "data": [["Item", "Qty", "Amount"],
                  ["Paper A4", "10", "48.00"],
                  ["Toner", "2", "170.00"],
                  ["Delivery", "1", "22.00"]]}
        Total of the Amount column: 240.00 across 3 line items.

因為代理持有行資料,接下來的步驟就是普通的問題:哪一行最大、總額是否與文字中列印的數字相符、將行寫入輸出資料夾中的 CSV。當算術結果很重要時,請求代理列出它加總的行,以便您檢查。

何時應該要求 Markdown 而非 JSON?

當結果由人閱讀時使用 Markdown,當程式碼使用時則使用 JSON。Markdown 為預設,也是最快查看表格並判斷是否正確擷取的方式。對於總計、交叉檢查以及任何要匯入試算表或資料庫的情況,請切換為 JSON。如果您知道表格所在位置,可縮小呼叫範圍:

提取第 4 頁的表格。

page 參數將偵測限制在單一頁面,這樣更快,且在計量授權下更省錢。

哪些情況仍需人工檢查?

對於表格而言,實際的限制比純文字更為重要。

  • 掃描檔沒有可供尋找的表格。 若無文字層則不存在表格結構,提取結果會是空的。此伺服器不提供 OCR。
  • 複雜版面多變。 合併儲存格、巢狀表格以及跨頁延續的表格並不總能如簡單格子般乾淨地保留。先抽樣檢查一份文件,再批次處理兩百份。
  • 評估模式受限。 若未取得授權,提取功能會受限制;具體限制請參閱函式庫的 授權頁面。在正式執行前,請求代理呼叫 get_license_status。

一鍵安裝

此伺服器僅以 Docker 映像檔方式發佈,沒有 dnx 指令。
在 Claude Code 中這樣註冊,將路徑替換為您的文件資料夾:

claude mcp add groupdocs-parser -- docker run --rm -i \
  -v /path/to/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest

Cursor、Claude Desktop、搭配 GitHub Copilot 的 VS Code、Windsurf、Cline 與 Codex 都使用相同的容器,只是使用客戶端特定的設定檔;每個皆列於 Register in AI clients.

常見問題

Claude 能準確讀取 PDF 表格嗎?
這取決於檔案本身以及客戶端如何將其扁平化,因此請實際檢查而非假設。使用 extract_tables 時,行資料來自文件引擎的表格偵測,以字串格子形式返回,Claude 會直接使用這些資料。

如何使用 AI 將 PDF 表格提取至 Excel?
先請求表格以 JSON 形式返回,然後請求代理將行寫入輸出資料夾中的 CSV,Excel 可直接開啟。從行到 CSV 的轉換是代理的步驟;儲存格值則來自工具。

它能在本機從 Word 與 Excel 檔案提取表格嗎?
可以。extract_tables 支援 DOCX 與 XLSX 以及 PDF,容器會從您掛載的資料夾讀取檔案。

深入了解