平台團隊如何使用 GroupDocs.Parser 在 .NET 上將文件工具整合到 MCP 客戶端
💡 完整的工作範例可在 GitHub 上取得: parser-mcp-document-tools-dotnet
平台挑戰:為何文件工具在 MCP 邊界卡住
Docker 支援的文件工具針對 MCP 客戶端是一種 GroupDocs.Parser.Mcp 在 .NET 上的部署模式,將容器映像與離線函式庫檢查(get_document_info、extract_text、extract_tables)配對。負責為助理提供文件工具的平台工程團隊很少會掙扎於「我們能解析 DOCX 嗎?」他們面臨的更嚴峻問題是:MCP 伺服器必須在客戶端設定中以具名工具清單的形式出現,而解析引擎又大到只能以容器映像而非 NuGet 套件的形式提供 GroupDocs.Parser.Mcp。
當產品小組要求取得文件資訊、純文字以及可於聊天中使用的表格時,平台團隊需要同時處理兩條路徑。路徑一是運營:docker run 並掛載 /data 資料卷、固定標籤如 :26.9.0,以及穩定的 mcpServers 條目。路徑二是驗證:證明 .NET 的 GroupDocs.Parser 回傳的事實與工具在實際握手前返回的結果相同。任一條路徑失誤,都會導致 MCP 客戶端回覆空白,而不是單元測試失敗。
這些團隊真正需要的是:一段可以貼入 MCP 客戶端的註冊程式碼片段,以及離線 C# 呼叫,將 JSON、文字與 Markdown 產出供審查。我在合作夥伴要求在聊天中使用 extract_tables,但 Docker 尚未在開發者筆記本上獲批時就遇到此需求——函式庫鏡像讓交付持續前進,而安全團隊完成容器審查。
Industry snapshot: GroupDocs.Parser.Mcp 於
ghcr.io/groupdocs-parser/parser-net-mcp發佈,並說明僅支援 Docker 發行,因為引擎大小超過 NuGet 限制。當地示範因此驗證等同工具的 API,無需實際 MCP 會話(MCP 文件)。
為何通用做法在此無法奏效
團隊通常在採用專屬 MCP 文件伺服器前會嘗試以下路徑:
- 臨時的 Shell 腳本搭配桌面轉換器:在 DOCX 與 XLSX 上脆弱,且不會呈現具名 MCP 工具。
- 僅在私有 API 中呼叫 Parser:在同一程序內可行,但 MCP 客戶端永遠看不到
get_document_info或extract_text作為一等工具。 - 等待 NuGet MCP 套件:此伺服器沒有此套件;唯一可用的路徑是容器映像。
GroupDocs.Parser 透過將 Docker MCP 伺服器與您 .NET 服務已使用的相同 Parser API 配對,彌補了這個缺口。
解決方案:在平台 MCP 工作流程中使用 GroupDocs.Parser
GroupDocs.Parser for .NET 成為 MCP 故事的驗證半部。Parser.GetDocumentInfo、Parser.GetText、GetFormattedText(Markdown) 與 GetTables 皆鏡像 GroupDocs.Parser.Mcp 向 MCP 客戶端公開的工具。範例倉庫會寫入 Result/mcp-server.example.json 作為註冊檔,然後對內建的 DOCX 與 XLSX 檔案執行三個最高流量的工具,讓操作人員可以在 Result/ 目錄下檢視輸出。
要遵循以下實作,您需要:
- .NET 8 SDK
- GroupDocs.Parser 26.10.0 (temporary license)
- 範例文件(倉庫內含
sample.docx、sample.xlsx、sample.pdf) - 只有在啟動即時 MCP 伺服器時才需要 Docker Engine
dotnet add package GroupDocs.Parser --version 26.10.0
步驟式實作 MCP 文件工具
以下說明如何註冊 GroupDocs.Parser.Mcp 並驗證等同工具的 API。情境符合平台小組在 .NET 8 上為助理上線文件工具的需求。
Step 1 - Emit the Docker MCP registration
寫入一個 mcpServers 條目,使容器以互動模式執行並掛載主機文件資料夾至 /data。在共享設定中固定標籤。
// JSON for MCP clients: docker run --rm -i -v <host>:/data <image>
string normalizedHost = hostDocumentsPath.Replace('\\', '/');
var payload = new
{
mcpServers = new
{
groupdocs_parser = new
{
command = "docker",
args = new[]
{
"run", "--rm", "-i",
"-v", $"{normalizedHost}:/data",
McpImage
}
}
},
繼續加入工具清單,並寫入 UTF-8 JSON 供客戶端匯入:
tools = new[]
{
"extract_text",
"extract_tables",
"extract_metadata",
"extract_images",
"extract_barcodes",
"get_document_info",
"get_license_status"
},
notes = "Pin the image tag in shared configs "
+ "(for example :26.9.0) instead of :latest."
};
var json = JsonSerializer.Serialize(
payload,
new JsonSerializerOptions { WriteIndented = true });
File.WriteAllText(outputPath, json, Encoding.UTF8);
Step 2 - Mirror get_document_info for preflight checks
MCP 客戶端常在較重的工具之前呼叫 get_document_info。使用 Parser.GetDocumentInfo 鏡像此合約,以保持 schema 穩定。
using var parser = new Parser(sourcePath);
var info = parser.GetDocumentInfo();
var payload = new
{
fileName = Path.GetFileName(sourcePath),
fileType = info?.FileType?.ToString(),
pageCount = info?.PageCount,
sizeBytes = info?.Size
};
File.WriteAllText(
outputPath,
JsonSerializer.Serialize(
payload,
new JsonSerializerOptions { WriteIndented = true }),
Encoding.UTF8);
為平台運營說明這些欄位的重要性:
fileType:確認解析器在執行文字工具前已辨識檔案格式pageCount:提供輕量訊號以估算 MCP 客戶端的上下文預算sizeBytes:支援配額與上傳檔案異常檢查
在內建的 sample.docx 上,執行結果會回報 Microsoft Word Open XML 類型、2 頁、15214 位元組。
Step 3 - Mirror extract_text for assistant-readable output
using var parser = new Parser(sourcePath);
using TextReader? reader = parser.GetText();
if (reader == null)
{
File.WriteAllText(outputPath, string.Empty, Encoding.UTF8);
return 0;
}
string text = reader.ReadToEnd();
File.WriteAllText(outputPath, text, Encoding.UTF8);
return text.Length;
回傳字元數可讓 CI 與主控台取得可量測的成功訊號,與操作人員對 MCP extract_text 工具的期待相符。
Step 4 - Mirror extract_tables as Markdown for chat UIs
優先使用格式化的 Markdown,若不可用則退回 GetTables 產生的管道表格,讓聊天客戶端保持一致的渲染路徑。
using var parser = new Parser(sourcePath);
using (TextReader? formatted = parser.GetFormattedText(
new FormattedTextOptions(FormattedTextMode.Markdown)))
{
if (formatted != null)
{
string markdown = formatted.ReadToEnd();
File.WriteAllText(outputPath, markdown, Encoding.UTF8);
int rows = 0;
using var sr = new StringReader(markdown);
string? line;
while ((line = sr.ReadLine()) != null)
{
if (line.Contains('|', StringComparison.Ordinal))
rows++;
}
return rows > 0
? rows
: (string.IsNullOrWhiteSpace(markdown) ? 0 : 1);
}
}
當格式化的 Markdown 不可用時,檢查功能與結構化表格:
if (!parser.Features.Tables)
{
File.WriteAllText(
outputPath,
"_Tables extraction is not supported for this file._\n",
Encoding.UTF8);
return 0;
}
IEnumerable<PageTableArea>? tables = parser.GetTables();
if (tables == null)
{
File.WriteAllText(outputPath, "_No tables returned._\n", Encoding.UTF8);
return 0;
}
下游系統可以將 Markdown 與原始 XLSX 並存,或直接將管道表格輸入 MCP 客戶端的聊天窗格,而不需第二個轉換器。
為何平台團隊需要同時保留 Docker MCP 與函式庫鏡像?
當 MCP 客戶端必須透過 ghcr.io/groupdocs-parser/parser-net-mcp 以具名工具呼叫位於 /data 的檔案時,保留 Docker MCP;當 PR 必須在沒有即時握手的情況下證明 get_document_info、extract_text、extract_tables 正確時,保留函式庫鏡像。這條雙軌路徑將容器政策與解析回歸分離。於生產標籤上釘住版本,並在每次 Parser 套件升級時於 CI 中執行 .NET 鏡像,如範例倉庫所示。
真實工作流程:為共享 MCP 客戶端群組上線文件工具
一個支援三個產品小組的平台團隊維護單一 MCP 客戶端基線。每個小組將 DOCX 政策與 XLSX 價格表放入共享文件卷。於推送新 parser-net-mcp 標籤前,團隊執行 .NET 主控台主機:重新產生註冊 JSON、將 document-info.json 與金標準值(2 頁 / 15214 位元組的測試 DOCX)比對、記錄文字字元數,並檢視 XLSX 範例的 Sheet1/Sheet2 Markdown 之管道表格結構。
此工作流程直接對應上述步驟。Step 1 為 fleet 設定;Step 2‑4 為離線門檻。只有在這些門檻通過後,釘住的容器映像才會部署至 MCP 客戶端主機。針對 Docker 特定失敗,操作人員可參考 MCP 疑難排解指南。
商業影響:此變更帶來的改變
| 指標 | 之前(臨時) | 之後(GroupDocs.Parser + MCP) |
|---|---|---|
| 客戶端註冊 | 手動備註,隨每台筆記本漂移 | 已檢入的 mcpServers JSON |
| 工具合約檢查 | 只有在即時 MCP 呼叫失敗後才發現 | 離線 JSON/文字/Markdown 固件 |
| 表格傳遞至聊天 | 自訂 CSV 轉換器 | 與 extract_tables 對齊的 Markdown |
| 套件分發 | 期待 NuGet MCP | 明確的 Docker‑only 伺服器 + NuGet 函式庫 |
| 映像漂移 | 浮動的 :latest |
釘住的標籤,例如 :26.9.0 |
| 稽核軌跡 | 只有聊天紀錄 | 每次執行的 Result/ 產出 |
綜合效應是加速 MCP 客戶端的上線,並減少當容器政策與解析行為走在不同時鐘上時的生產意外。
其他平台情境的適用範例
註冊與鏡像就緒後,同樣的 API 可支援:
- 前置檢查門檻:在 MCP 客戶端執行前,根據
pageCount或sizeBytes超出政策即拒絕上傳 - 試算表簡報:將 XLSX 產出的 Markdown 表格送入站會機器人
- 多格式煙霧測試包:保留 DOCX、XLSX、PDF 範例於 MCP 設定旁,以供每週回歸測試
- Sidecar 部署:在仍使用內部 Parser 處理工作的 .NET API 旁執行 GroupDocs.Parser.Mcp
在您的平台環境中快速上手
您已了解 GroupDocs.Parser 如何為平台團隊在 .NET 上處理 MCP 文件工具。接下來的步驟:
- 開始免費使用:取得臨時授權
- 閱讀 MCP 設定說明:GroupDocs.Parser MCP 文件
- 參考使用案例:透過 MCP 解析文件
- 瀏覽範例程式碼:GroupDocs.Parser for .NET 範例
- 提問交流:Parser 論壇