groupdocs-editor-mcp

GroupDocs.Editor MCP Server

Claude、Cursor、GitHub Copilot、その他あらゆる MCP エージェントが、書式を崩さずに Word、Excel、PowerPoint、PDF、テキスト文書を編集できます。テキストをその場で置換したり、文書（または 1 つのワークシート、スライド、PDF のページ範囲）を編集可能な HTML に変換して編集後に元に戻したり、Word のフォームフィールドに入力したりできます。 ローカルで実行する場合、ファイルがマシンの外に出ることはありません。

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.Editor.Mcp --yes

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

dnx [email protected] --yes

サーバーは GROUPDOCS_MCP_STORAGE_PATH（デフォルト：現在のディレクトリ）で文書を読み書きします。編集したコピーは元のファイルと同じ場所に保存され、既存のファイルが上書きされることはありません。

Claude Desktop

claude_desktop_config.json に追加します：

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

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

Claude Code

claude mcp add groupdocs-editor -- dnx GroupDocs.Editor.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 を作成します。

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-editor -- dnx GroupDocs.Editor.Mcp --yes を実行します。詳細は install/generated/codex.md を参照してください。

Docker

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

イメージは GHCR（ghcr.io/groupdocs-editor/editor-net-mcp）と Docker Hub （groupdocs/editor-net-mcp）で linux/amd64 および linux/arm64 向けに公開されています。タグは latest に加え、各 NuGet リリースに対応する変更不可のバージョンタグ（例：:26.10.0）が付与されます。イメージにネイティブ環境のセットアップは不要です。

Linux での Docker：コンテナを自分のユーザーとして実行する

イメージは root 以外のユーザー（uid 1654）として実行され、バインドマウントではホスト側の所有者が維持されます。そのため、Linux ホストでは、コンテナを自分のユーザーとして実行しない限り、サーバーが /data に書き込む編集済みファイルはすべて Permission denied エラーになります：

docker run --rm -i --user "$(id -u):$(id -g)" \
  -v "$(pwd)/documents:/data" \
  ghcr.io/groupdocs-editor/editor-net-mcp:latest

JSON のクライアント設定ではシェルを実行しないため、数値を "args": ["run", "--rm", "-i", "--user", "1000:1000", …] に記述します。Windows および macOS の Docker Desktop では不要です。

グローバル dotnet ツール

dotnet tool install -g GroupDocs.Editor.Mcp
groupdocs-editor-mcp

利用可能な MCP ツール

ツール	説明
get_document_info	形式ファミリー、形式、ページ数／ワークシート数／スライド数、サイズ、暗号化の有無、および保存可能な形式を返します（JSON）。
extract_html	ドキュメント全体、または1つのワークシート、スライド、PDFページ範囲を編集可能な HTML に変換してストレージに保存し、プレーンテキストのプレビューも返します。デフォルトでは自己完結型です。embedResources=false を指定すると <name>_resources フォルダーに書き込みます。
save_from_html	編集済み HTML を DOCX、DOC、RTF、ODT、XLSX、XLS、ODS、CSV、PPTX、PPT、ODP、PDF、XPS、TXT、Markdown、MHTML、EPUB、MOBI、AZW3、EML、MSG として保存します。sourceFile と worksheet／slide を指定すると、編集した部分だけを元のファイルに差し戻し、他のすべての部分を保持します。
replace_text	書式を保持して検索・置換します。リテラル、大文字小文字を区別しない検索、単語単位、正規表現に対応します。一度に処理できるのは1つのワークシートまたはスライドです。出力形式は任意で指定できます。変更された件数を報告し、一致がない場合は何も書き込みません。
get_supported_formats	ファミリーごとに GroupDocs.Editor が開いて保存できる形式、または指定したファイルの保存先形式を返します（JSON）。
get_form_fields	Word ドキュメントのフォームフィールド（テキストボックス、チェックボックス、ドロップダウン、数値フィールド、日付フィールド）を種類と値とともに一覧表示します（JSON）。
fill_form_fields	Word のフォームフィールドに値を入力して、入力済みのコピーを保存します。不明なフィールド名や入力できない値は無視せず報告します。
get_license_status	ライセンスモード、従量制の使用状況、エンジンのバージョンを返します（GroupDocs.Mcp.Core に同梱）。

ワークシート、スライド、ページの番号は1始まりです。すべての失敗では isError が設定され、ツールのプレフィックスで始まるメッセージが返されます。例：HTML extraction failed for 'report.docx': …。そのため、クライアントでの確認は1回で済みます。

AI エージェント向けのプロンプト例

Replace "ACME Corp" with "Globex" in contract.docx and keep the formatting.
Give me the second worksheet of budget.xlsx as HTML so I can edit it.
Save edited.html back as a Word document, and also as a PDF.
Fill the form fields in application.docx: name = Jane Doe, agree = yes.
Which formats can GroupDocs.Editor open and save?

評価モード

MCP サーバー自体は MIT ライセンスですが、GroupDocs.Editor エンジンを本番環境で使用するにはライセンスが必要です。 ライセンスがなくてもすべてのツールは動作しますが、次の制限があります（GroupDocs.Editor 26.6.1 で測定）。

• 編集した出力には評価版のバナー（「Created with evaluation version of GroupDocs.Editor …」）が表示されます。
• 保存したワークブックに追加のワークシートが追加されます。
• PDF の最初の 2 ページ、ワークブックの最初の 2 つ（表示されている）ワークシート、およびプレゼンテーションの最初の 2 枚のスライドのみ編集できます。エンジンはそれより後の番号を指定すると、黙って 2 番目の部分を返します。サーバーは代わりにリクエストを拒否し、その理由を通知します。編集した部分をワークシートまたはスライドの 3 番目以降に保存することには制限がありません。

編集ツールのレスポンスは、先頭に Evaluation mode: の行が追加されます。現在有効なモードを確認するには、 get_license_status を呼び出してください。

ライセンス

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

ライセンスファイル — GROUPDOCS_LICENSE_PATH に GroupDocs.Editor（または GroupDocs.Total）の ライセンスファイルへのパスを設定します。オフラインで動作します。

従量課金 — GROUPDOCS_METERED_PUBLIC_KEY と GROUPDOCS_METERED_PRIVATE_KEY の両方を設定します。処理した分だけ支払うため、エージェントのワークロードに適しています。従量課金キーのペアとライセンスファイルの両方が設定されている場合は、従量課金が優先され、ライセンスファイルは無視されます。

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

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

従量課金の秘密鍵は秘匿情報です。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-editor/editor-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.Editor は Aspose.Drawing（マネージド）と SkiaSharp を介して描画します。ネイティブライブラリはパッケージ内に含まれているため、どのプラットフォームでも libgdiplus は必要ありません。編集したコンテンツを PDF または XPS に保存する場合はテキストをレイアウトするため、Linux では実際のフォントが必要です。

プラットフォーム	セットアップ
Windows	不要です。
Linux	sudo apt-get install -y libfontconfig1 ttf-mscorefonts-installer（PDF/XPS 出力の場合のみ）
macOS	不要です。
Docker	不要です。イメージにフォントが含まれています。

制限事項

• replace_text は、1つの書式設定ラン内で一致を検索します。 書式設定の異なるテキスト（前半は太字、後半は太字ではないなど）にまたがる語句は一致しません。そのような編集には extract_html と save_from_html を使用してください。
• PDF の編集は変換処理です。 PDF は流し込み形式の HTML に変換され、編集後に PDF に戻されるため、複雑なレイアウトは完全には保持されません。忠実性が重要な場合は、編集結果を DOCX として保存してください。
• PPTX とメールの出力には元ファイルが必要です。 save_from_html は HTML のみから DOCX、XLSX、PDF、TXT、Markdown、EPUB を作成します。PPTX と EML/MSG の場合は、元ファイルを sourceFile として渡してください。
• リモートリソース。 リモート画像やスタイルシートを参照する HTML または Office ファイルを読み込む際、エンジンがそれらを取得する場合があります。信頼できない入力を扱う場合は、ネットワークへの送信を無効にしてサーバーを実行してください。
• macOS CI。 統合テストは Linux と Windows で実行されます。macOS 全体で発生するランナーのハングは、別途追跡されています。

Docker Compose での使用

cd docker
docker compose up

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

ドキュメントとガイド

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

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

このリポジトリでは、公開済みパッケージ（Linux、Windows、macOS での dnx）と Docker イメージに対して、紹介されているすべてのツールをテストし、編集内容をすべてサーバー経由で読み戻します。

ライセンス

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