プラットフォームチームがGroupDocs.Parserを使用して.NET上のMCPクライアントにドキュメントツールを組み込む方法
💡 完全な動作例はGitHubで入手可能です: parser-mcp-document-tools-dotnet
プラットフォームの課題:なぜドキュメントツールがMCPの境界で停滞するのか
Docker バックエンドのドキュメントツールは、MCP クライアント向けの GroupDocs.Parser.Mcp デプロイパターンで、コンテナイメージと get_document_info、extract_text、extract_tables のオフラインライブラリチェックを組み合わせます。アシスタント向けにドキュメントツールを提供するプラットフォームエンジニアリングチームは、たいてい「DOCX を解析できるか?」という問題ではなく、より鋭い壁に直面します。MCP サーバーはクライアント設定に名前付きツールリストとして現れなければならず、解析エンジンが大きすぎるため GroupDocs.Parser.Mcp はコンテナイメージとしてのみ提供され、NuGet パッケージとしては提供されません。
製品チームが MCP クライアント内でドキュメント情報、プレーンテキスト、チャット対応テーブルを要求すると、プラットフォームチームは 2 つのトラックを引き受けます。トラック 1 は運用:docker run に /data ボリュームをマウントし、:26.9.0 などの固定タグと安定した mcpServers エントリを使用します。トラック 2 は検証:GroupDocs.Parser for .NET がライブハンドシェイクに依存する前に、ツールが返すのと同じ事実を返すことを証明します。どちらかのトラックが欠けると、失敗は空の MCP クライアント応答として現れ、ユニットテストの失敗とはなりません。
これらのチームが必要としているのは明確です。MCP クライアントに貼り付けられる登録スニペットと、JSON、テキスト、Markdown アーティファクトを書き出すオフライン C# 呼び出しです。パートナーが Docker が開発者ラップトップで承認される前にチャットで extract_tables を要求したときにこの問題に直面しましたが、ライブラリミラーが配信を継続させ、セキュリティがコンテナレビューを完了する間に対応できました。
業界スナップショット: GroupDocs.Parser.Mcp は
ghcr.io/groupdocs-parser/parser-net-mcpに公開されており、エンジンが NuGet サイズ制限を超えるため Docker のみの配布となっています。ローカルデモはライブ MCP セッションを必要とせずにツール同等の API を検証します(MCP ドキュメント)。
なぜ汎用的アプローチがここで通用しないのか
チームは専用の MCP ドキュメントサーバーを採用する前に、通常以下のいずれかの方法を試します。
- デスクトップコンバータを囲むアドホックシェルスクリプト: 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 ファイルに対して最も利用頻度の高い 3 つのツールを実行し、オペレーターが 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 - Docker MCP 登録情報を出力
コンテナを対話的に実行し、ホストのドキュメントフォルダーを /data にマウントする mcpServers エントリを書き込みます。共有設定でタグを固定します。
// 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 - preflight チェック用に get_document_info を鏡像
MCP クライアントは重いツールを呼び出す前に get_document_info を呼ぶことが多いです。その契約を Parser.GetDocumentInfo で鏡像し、スキーマの安定性を保ちます。
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 - アシスタントが読みやすい出力のために extract_text を鏡像
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 - チャット UI 用に extract_tables を Markdown で鏡像
フォーマット済み 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 クライアントが /data 配下のファイルに対して名前付きツールを呼び出す必要がある場合は Docker MCP を保持します。ghcr.io/groupdocs-parser/parser-net-mcp を介して実行します。ライブハンドシェイクなしで get_document_info、extract_text、extract_tables を証明する必要がある PR ではライブラリミラーを保持します。この二重パスによりコンテナポリシーと解析リグレッションが分離されます。プロダクションタグを固定し、Parser パッケージが更新されるたびに .NET ミラーを CI で実行します(サンプルリポジトリ参照)。
実際のワークフロー:共有 MCP クライアントフリートへのドキュメントツールオンボーディング
3 つのプロダクトスクワッドを支援するプラットフォームチームは、1 つの MCP クライアントベースラインを維持します。各スクワッドは DOCX ポリシーと XLSX レートシートを共有ドキュメントボリュームに投入します。新しい parser-net-mcp タグを昇格させる前に、チームは .NET コンソールホストを実行します:登録 JSON が再生成され、document-info.json がゴールデン値(スモーク DOCX の 2 ページ / 15214 バイト)と比較され、テキスト文字数がログに記録され、XLSX サンプルの Sheet1/Sheet2 Markdown がパイプテーブル構造としてレビューされます。
このワークフローは上記手順に直接マッピングされます。Step 1 がフリート設定、Step 2‑4 がオフラインゲートです。これらのゲートを通過した後にのみ、固定タグのコンテナイメージが MCP クライアントホストにロールアウトされます。Docker 固有の失敗については、MCP トラブルシューティングガイド を参照してください。
ビジネスインパクト:これが変えること
| メトリック | 従来(アドホック) | 変更後(GroupDocs.Parser + MCP) |
|---|---|---|
| クライアント登録 | 手動メモ、ラップトップごとにドリフト | mcpServers JSON をチェックイン |
| ツール契約チェック | ライブ MCP 呼び出し失敗後にのみ | オフライン JSON/テキスト/Markdown フィクスチャ |
| チャットへのテーブル配信 | カスタム CSV コンバータ | extract_tables に合わせた Markdown |
| パッケージ配布 | NuGet MCP の期待 | Docker のみのサーバー + NuGet ライブラリが明確 |
| イメージドリフト | :latest の浮動 |
:26.9.0 などの固定タグ |
| 監査トレイル | チャットログのみ | 実行ごとの Result/ アーティファクト |
この複合効果により、MCP クライアントのオンボーディングが高速化し、コンテナポリシーと解析挙動が別々のタイムラインで進む際の本番サプライズが減少します。
他のプラットフォームシナリオでの適用例
登録とミラーが整ったら、同じ API が以下をサポートします。
- 事前インジェストゲート:
pageCountやsizeBytesがポリシー外の場合にアップロードを拒否し、MCP クライアントが実行される前にチェック - スプレッドシートブリーフィング: XLSX から Markdown テーブルをスタンドアップボットに送信
- マルチフォーマットスモークパック: DOCX、XLSX、PDF サンプルを MCP 設定横に置き、週次リグレッションに活用
- サイドカーロールアウト: GroupDocs.Parser.Mcp を、内部ジョブでインプロセス Parser をまだ使用している .NET API の横で実行
プラットフォーム環境での開始手順
GroupDocs.Parser が .NET 上のプラットフォームチーム向けに MCP ドキュメントツールをどのように扱うかをご理解いただけたと思います。次のステップへ進んでください。
- 無料で開始: 一時ライセンスを取得
- MCP 設定を読む: GroupDocs.Parser MCP ドキュメント
- ユースケースに従う: MCP 経由でドキュメントを解析
- サンプルを閲覧: GroupDocs.Parser for .NET サンプル
- 質問する: Parser フォーラム