groupdocs-total-mcp

GroupDocs.Total MCP サーバー

GroupDocs.Total のドキュメント処理ツール一式（注釈、比較、変換、Markdown、結合、メタデータ、解析、墨消し、署名、透かし、および製品を横断したドキュメントの検査とページプレビュー）を、Claude、Cursor、GitHub Copilot、その他の MCP エージェントから呼び出せるツールとして公開する統合 MCP サーバーです。単独での使用を想定しているため、個別の製品 MCP（GroupDocs.Annotation.Mcp、GroupDocs.Signature.Mcp など）を併せて接続する必要はなく、接続するとツールが重複します。

インストール

ワンクリックインストールでは、サポート対象の設定がすべて事前入力されます。インストール後、ボリュームマウント内のホストパスのプレースホルダーを編集してください。GROUPDOCS_LICENSE_PATH が空の場合、評価モードで実行されます。

その他のクライアント — Claude Code、Codex CLI、Visual Studio 2022、 Cursor、Windsurf、Cline、JetBrains Rider 用のすぐに使える設定は install/generated/ にあります。

この製品は Docker（GHCR）経由でのみ提供されます。 GroupDocs.Total はすべてのエンジン（Parser に組み込まれた ONNX モデルを含む）をバンドルしているため、パッケージのサイズが NuGet.org の 250 MB の上限を大幅に超えます。そのため、dnx と dotnet tool install は利用できません。上流で上限内に収まる、より軽量なエンジンが提供されれば、標準の NuGet フローが復活します（.github/workflows/publish_prod.yml の元に戻すためのメモを参照してください）。

docker run --rm -i \
  -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-total/total-net-mcp:latest

イメージはマルチアーキテクチャ（linux/amd64 + linux/arm64）に対応し、latest に加えて、リリースごとに変更されないバージョンタグ（例：:26.9.0）が付与されています。タグを固定するには、:latest をバージョンタグに置き換えてください。共有設定や CI では、この方法を推奨します。

利用可能な MCP ツール（合計 38 個）

ツール名には、ドメイン間で区別できるよう {Product}{Verb}{Noun} の PascalCase を使用します。複数の製品にまたがるツール名は短くしています。

複数製品共通（2）

ツール	説明
GetDocumentInfo	任意のドキュメントのファイル形式、ページ数、サイズを JSON で取得します（Parser エンジンにより 170 以上の形式に対応）
GetDocumentPageImage	最大 5 ページをインライン PNG 画像としてレンダリングします（Viewer エンジン、170 以上の形式に対応）

Annotation（8）

ツール	説明
AnnotationAddAnnotation	テキストフィールド／領域／点／矢印／ハイライト／下線／取り消し線の注釈を追加します
AnnotationGetAnnotations	すべての注釈を JSON で一覧表示します（id、type、message、page、box、user、replies）
AnnotationUpdateAnnotation	id を指定して、既存の注釈のメッセージやバウンディングボックスを変更します
AnnotationRemoveAnnotations	id のリストを指定して注釈を削除するか、すべて削除します
AnnotationAddReply	既存の注釈に返信／コメントスレッドを追加します
AnnotationRemoveReplies	id、ユーザー名を指定して返信を削除するか、すべて削除します
AnnotationImportAnnotations	XML または注釈付きの別のドキュメントから注釈をインポートします
AnnotationExportAnnotations	注釈を XML に抽出します（Import で再インポート可能）

署名（7）

ツール	説明
SignatureSign	テキスト／QR コード／バーコード／デジタル証明書による署名を追加します
SignatureVerify	署名を検証し、有効性レポートを JSON で返します
SignatureSearchTextSignatures	任意の部分文字列フィルターを使用して、埋め込みテキスト署名を検索します
SignatureSearchBarcodes	任意のデコード済みテキストフィルターを使用して、バーコード署名を検索します
SignatureSearchQrCodes	任意のデコード済みテキストフィルターを使用して、QR コード署名を検索します
SignatureSearchDigitalSignatures	デジタル証明書署名（署名者、発行者、有効性）を検索します
SignatureSearchImageSignatures	埋め込み画像署名を検索し、base64 PNG として返します

比較（1）・変換（2）・Markdown（2）

ツール	説明
ComparisonCompare	2 つのドキュメントを比較し、注釈付きの差分ドキュメントを作成します
ConversionConvert	PDF、Office、画像、HTML、およびその他 50 以上の形式間で変換します
ConversionGetSupportedFormats	ドキュメントの変換先として利用できるすべての形式を一覧表示します
MarkdownConvertToMarkdown	PDF／Office／EPUB／MOBI をクリーンな Markdown に変換します
MarkdownComposeFromMarkdown	Markdown ソースから DOCX／PDF／HTML を作成します

結合（2）・メタデータ（2）

ツール	説明
MergerMerge	最大 4 つのドキュメントを 1 つに結合します（PDF／Office／HTML／画像）
MergerSplit	ページ番号に基づいてドキュメントを個別のファイルに分割します
MetadataReadMetadata	すべてのメタデータプロパティ（作成者、タイトル、EXIF、XMP、IPTC、カスタム）を JSON として読み取ります
MetadataRemoveMetadata	すべてのメタデータを削除し、クリーンなコピーを保存します

パーサー（5）・墨消し（4）・透かし（3）

ツール	説明
ParserExtractText	プレーンテキストを抽出します（ページごと、またはドキュメント全体）
ParserExtractImages	埋め込み画像を抽出し、ストレージに保存します
ParserExtractTables	テーブルを Markdown または JSON として抽出します
ParserExtractMetadata	メタデータフィールドを抽出します（MetadataReadMetadata とは別で、Parser が対応する形式に準拠）
ParserExtractBarcodes	ドキュメントのページに埋め込まれたバーコードを検索してデコードします
RedactionRedactText	正規表現に一致するテキストを置換文字列で墨消しします
RedactionRedactImageArea	ドキュメントページの四角形領域を黒く塗りつぶします
RedactionRedactAnnotations	正規表現に一致する注釈を墨消しまたは削除します
RedactionEraseMetadata	Redaction エンジンを使用してメタデータを削除します（Metadata が対応していない形式も処理できます）
WatermarkAddWatermark	フォント、回転、不透明度を設定できるテキストの透かしを追加します
WatermarkSearchWatermarks	既存の透かしを JSON で一覧表示します（種類、テキスト、位置、ページ）
WatermarkRemoveWatermarks	テキストフィルターを指定して、またはすべての透かしを削除します

プロンプトの例

• 「contract.docx を PDF に変換し、『Signed by Alice』を含む QR コードで署名してから、すべてのページに『CONFIDENTIAL』の透かしを入れてください」
• 「old.pdf と new.pdf を比較し、結果内のすべての注釈を一覧表示して、1 ページ目をプレビューしてください」
• 「report.xlsx からすべてのテーブルを Markdown として抽出し、すべてのメールアドレスを墨消ししてください」
• 「/uploads 内のすべての PDF のメタデータを読み取り、削除してから、それぞれのクリーンアップ済みの 1 ページ目をプレビューしてください」
• 「invoice.pdf 内のすべてのバーコードを検索してから、invoice.pdf と receipt.pdf を combined.pdf に結合してください」

ライセンス

MCP サーバー自体は MIT ライセンスですが、基盤となる GroupDocs エンジンを本番環境で使用するにはライセンスが必要です。 ライセンスがない場合、サーバーは評価モードで動作します。

• 同梱されている各エンジンには、それぞれ独自の評価制限があります。出力への透かし／評価通知、ページ数の制限、プロセスごとのドキュメントオープン数の上限（エンジンに応じて 1～15 件）が適用されます。

制限を解除するには、GroupDocs.Total.lic をコンテナにマウントし、GROUPDOCS_LICENSE_PATH にそのパスを指定してください（上記の Claude Desktop の例を参照）。

• 30 日間の無料一時ライセンスを取得
• ライセンスを購入 | 製品ページ

設定

変数	説明	デフォルト
GROUPDOCS_MCP_STORAGE_PATH	入力ファイルと出力ファイルのベースフォルダー	現在のディレクトリ
GROUPDOCS_MCP_OUTPUT_PATH	(任意) 出力ファイル用の別フォルダー	GROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATH	GroupDocs ライセンスファイルへのパス	（評価モード）

Claude Desktop での使用方法

{
  "mcpServers": {
    "groupdocs-total": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/documents:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]
    }
  }
}

ライセンスを使用するには、イメージ名の前に "-v", "/path/to/license-folder:/license", "-e", "GROUPDOCS_LICENSE_PATH=/license/GroupDocs.Total.lic" を追加してください。 バージョンを固定するには、:latest をリリースタグに置き換えてください。

VS Code / GitHub Copilot での使用方法

上記の VS Code にインストール ボタンを使用するか、.vscode/mcp.json に追加してください （install/generated/vscode-mcp.json にもあります）。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "storage_path",
      "description": "Base folder for input and output files.",
      "password": false
    }
  ],
  "servers": {
    "groupdocs-total": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "${input:storage_path}:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]
    }
  }
}

Docker Compose での使用方法

cd docker
docker compose up

docker/docker-compose.yml を編集し、ボリュームがローカルのドキュメントフォルダーを指すようにしてください。

ライセンス

MIT — LICENSE を参照