groupdocs-conversion-mcp

GroupDocs.Conversion MCP サーバー

Claude、 Cursor、GitHub Copilot、その他のあらゆる MCP エージェントから、PDF、Word、Excel、PowerPoint、HTML、画像、70 種類以上のドキュメント形式を変換できます — ローカルで処理するため、ファイルがマシンの外に出ることはありません。

60 秒でインストール

ワンクリックインストールでは、サポートされているすべての設定があらかじめ入力されます。インストール後にプレースホルダーのドキュメントフォルダーを編集してください（出力先はデフォルトで同じフォルダーです）。GROUPDOCS_LICENSE_PATH を空にすると評価モードで実行されます。制限を解除するには、ライセンスへのパスを指定してください。

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

ネイティブ実行には .NET 10 SDK が必要です — または、そのまま Docker をご利用ください。

dnx で直接実行（推奨 — インストール不要）：

dnx GroupDocs.Conversion.Mcp --yes

実行のたびに最新の安定版リリースを取得します。特定の バージョンに固定するには（共有設定や CI では推奨）、@<version> を追加します。

dnx [email protected] --yes

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

ライセンスを使用するには、"GROUPDOCS_LICENSE_PATH": "/path/to/GroupDocs.Total.lic" を env に追加してください — 評価モードで実行する場合は省略します。

Claude Code

claude mcp add groupdocs-conversion -- dnx GroupDocs.Conversion.Mcp --yes

VS Code / GitHub Copilot

上記の Install in VS Code ボタンを使用するか、NuGet パッケージページから用意済みのスニペットをコピーして .vscode/mcp.json に貼り付けるか、このリポジトリから install/generated/vscode-mcp.json を取得してください。

Visual Studio 2022 (17.14+)

ソリューションのルートに install/generated/vs2022-mcp.json の内容を使って .mcp.json を作成してください。形式は VS Code のものと同じです。すでに Visual Studio を使用している .NET チーム向けのネイティブな方法です。

Cursor · Windsurf · Cline · Rider · Codex

• Cursor — 上記の Add to Cursor ボタンを使用するか、install/generated/claude-desktop.json を ~/.cursor/mcp.json に貼り付けてください。
• Windsurf — install/generated/windsurf.md の手順に従ってください。
• Cline — install/generated/cline.json を Cline の MCP 設定に貼り付けてください。
• JetBrains Rider — install/generated/rider.md の手順に従ってください。
• Codex CLI — codex mcp add groupdocs-conversion -- dnx GroupDocs.Conversion.Mcp --yes を実行してください。詳細は install/generated/codex.md を参照してください。

Docker

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

イメージは GHCR（ghcr.io/groupdocs-conversion/conversion-net-mcp）と Docker Hub（groupdocs/conversion-net-mcp）の両方に、linux/amd64 と linux/arm64 向けに公開されています。タグは latest と、各 NuGet リリースに対応する変更不可のバージョンタグ（例：:26.9.0）です。

グローバル dotnet ツール

dotnet tool install -g GroupDocs.Conversion.Mcp
groupdocs-conversion-mcp

バージョンの固定： 上記のいずれかのスニペットで、"GroupDocs.Conversion.Mcp" を "[email protected]" に置き換えると、特定のリリースに固定できます。予期しないアップグレードを避けるため、共有またはコミットする設定ではバージョンの固定を推奨します。

利用可能な MCP ツール

ツール	説明
Convert	ドキュメントを別の形式（PDF、DOCX、XLSX、PPTX、HTML、PNG、JPG など、70 種類以上）に変換し、結果をストレージに保存します
GetSupportedFormats	ソースドキュメントを変換できるすべての出力形式を、プライマリ／セカンダリの区分とともに一覧表示します
GetDocumentInfo	ソースドキュメントのファイル形式、ページ数、基本プロパティ（作成者、タイトル、日付、パスワード保護の有無）を返します

ライセンス

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

• 変換された出力には評価用の透かしが入り、ツールの応答には評価モードであることを示す通知が含まれます。
• 1 つのサーバープロセスで開けるドキュメントは最大 15 件です。それを超える呼び出しは、サーバーを再起動するまで "Could not open more than 15 document files in evaluation mode" というエラーで失敗します。

サーバーにライセンスを適用する方法は 2 つあります。

ライセンスファイル — GROUPDOCS_LICENSE_PATH に GroupDocs.Total.lic のパスを設定します。オフラインで動作します。

従量課金制 — GROUPDOCS_METERED_PUBLIC_KEY と GROUPDOCS_METERED_PRIVATE_KEY の両方を設定します。実際に処理した分だけ課金されるため、使用量が急増しやすく事前の予測が難しい AI エージェントに適しています。従量課金キーのペアとライセンスファイルの両方が設定されている場合は、従量課金が優先され、ライセンスファイルは無視されます。

従量課金モードには外部への接続が必要です。 使用状況は GroupDocs サーバーに報告されるため、ネットワークから隔離された環境やファイアウォールで保護された環境では、その外向き通信を許可する必要があります。許可できない場合は、代わりにライセンスファイルを使用してください。

いつでも get_license_status ツールを呼び出すと、有効なモードを確認できます。従量課金の場合は、消費量と残りのクレジットも確認できます。

設定ファイルに秘密鍵を記載しない

従量制の秘密鍵は機密情報です。MCP クライアントの設定はディスク上のプレーンテキストファイルであり、プロジェクトスコープの .mcp.json は慣例上コミットされるため、次の優先順位で設定してください。

1. OS の環境変数に設定し、設定ファイルには記載しないでください。 stdio MCP サーバーはクライアントの環境を引き継ぐため、どのクライアントでも機能します。macOS では、Finder から起動したアプリはシェルのエクスポート値を引き継がない点に注意してください。launchctl setenv を使うか、ターミナルからクライアントを起動してください。
2. クライアントが対応している場合は、間接的に参照してください（Claude Code は ${VAR} を展開し、VS Code は ${env:VAR} と ${input:...} を使用します）。
3. ユーザースコープの設定ファイル（例：~/.claude.json）にリテラル値を記載する方法は、単独の開発者であれば許容されます。
4. プロジェクトスコープの .mcp.json にリテラルのキーをコミットすることは、絶対に避けてください。

Docker では、値をファイルに書き込まずに渡してください。

docker run --rm -i \
  -e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \
  -v /path/to/documents:/data \
  ghcr.io/groupdocs-conversion/conversion-net-mcp:latest

ライセンスファイルを使って制限を解除するには： 上記の各インストール例にあるコメントアウトされた例を参照してください。

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

設定

変数	説明	デフォルト
GROUPDOCS_MCP_STORAGE_PATH	入力ファイルと出力ファイルのベースフォルダー	現在のディレクトリ
GROUPDOCS_MCP_OUTPUT_PATH	(任意) 出力ファイル用の個別フォルダー	GROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATH	GroupDocs ライセンスファイルのパス	（評価モード）
GROUPDOCS_METERED_PUBLIC_KEY	従量制の公開鍵。秘密鍵も必要です。ライセンスファイルより優先されます	（未設定）
GROUPDOCS_METERED_PRIVATE_KEY	従量制の秘密鍵。機密情報 — ライセンスを参照してください	（未設定）

ネイティブ環境の前提条件

基盤となる GroupDocs エンジンは、一部の操作で System.Drawing（GDI+）を使用します。Linux または macOS でサーバーをネイティブに（dnx またはグローバルの dotnet ツール経由で）実行する場合は、先にネイティブの libgdiplus ライブラリをインストールしてください。

プラットフォーム	セットアップ
Windows	不要 — GDI+ は OS に組み込まれています。
Linux	sudo apt-get install -y libgdiplus libfontconfig1 ttf-mscorefonts-installer
macOS	brew install mono-libgdiplus
Docker	不要 — イメージに libgdiplus がすでに含まれています。

Linux/macOS でこれを省略すると、ツールの応答に DllNotFoundException: libgdiplus が表示されます。Linux/macOS で最も簡単な、セットアップ不要の方法はDocker イメージです。

Docker Compose での使用

cd docker
docker compose up

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

ドキュメントとガイド

ステップごとのデプロイガイドと、公開パッケージを対象とした統合テストスイートは、関連リポジトリ GroupDocs.Conversion.Mcp.Tests にあります。

• NuGet からインストールする — dnx、グローバルツール、バージョンを固定する方法と常に最新を使う方法
• Docker 経由で実行する
• MCP レジストリで確認する
• Claude Desktop で使用する
• VS Code / GitHub Copilot で使用する
• 統合テストを実行する

このリポジトリでは、CI で Linux、macOS、Windows 上の公開済み NuGet アーティファクトを使って、紹介しているすべてのツールもテストしています。そのため、上記のスニペットはリリースごとにエンドツーエンドで検証されます。

ライセンス

MIT — LICENSE を参照してください