groupdocs-watermark-mcp

GroupDocs.Watermark MCP サーバー

GroupDocs.Watermark を、Claude、Cursor、GitHub Copilot、その他の MCP エージェントから呼び出せる AI ツールとして公開する MCP サーバーです。

インストール

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

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

.NET 10 SDK が必要です。

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

dnx GroupDocs.Watermark.Mcp --yes

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

dnx [email protected] --yes

または、グローバル dotnet ツールとしてインストール：

dotnet tool install -g GroupDocs.Watermark.Mcp
groupdocs-watermark-mcp

または、Docker 経由で実行：

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

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

基盤となる 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 イメージを使用することです。

利用可能な MCP ツール

ツール	説明
AddWatermark	テキストの透かし（Arial、サイズと回転角度を設定可能）をドキュメントに追加し、透かし入りファイルをストレージに保存します
AddImageWatermark	画像の透かし（ロゴ、署名のスキャン画像、スタンプ）をドキュメントに追加し、透かし入りファイルを保存します。不透明度と回転角度を設定できます
SearchWatermarks	ドキュメント内の既存の透かし（テキストと画像）を検索し、その詳細（種類、テキスト、ページ、位置、サイズ、回転角度）を JSON で返します
RemoveWatermarks	ドキュメントから既存の透かしを削除し、クリーンなコピーを保存します。任意のテキストフィルターを指定して、一致する透かしだけを削除できます
GetDocumentInfo	ドキュメントのファイル形式、ページ数、各ページの寸法を JSON で返します。ドキュメントは変更しません

すべてのツールは、PDF、DOCX、XLSX、PPTX、PNG、JPG、VSDX など、50 種類以上のドキュメントおよび画像形式に対応しています。

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

サーバーへの接続後に、次のいずれかを Claude Desktop、Cursor、または GitHub Copilot Chat にコピーしてください。AI エージェントが適切なツールと引数を自動的に選択します。ファイル名は GROUPDOCS_MCP_STORAGE_PATH を基準に解決されます。

1. DRAFT のテキスト透かしを追加する：「report.pdf にテキスト 'DRAFT' の透かしを追加してください。」
2. ロゴ画像をスタンプする：「company-logo.png を contract.docx のすべてのページに画像の透かしとして使用し、不透明度を 30% にしてください。」
3. 既存の透かしを確認する：「invoice.pdf にはどのような透かしが含まれていますか？」
4. 古い透かしを削除する：「final-draft.docx からすべての透かしを削除して、納品できるようにしてください。」
5. ドキュメントの構造を確認する：「presentation.pptx は何ページあり、各ページの寸法はどのくらいですか？」

ライセンス

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

• エンジンは、処理後の出力に追加の評価用透かしを挿入します。
• 1 つのサーバープロセスで読み込めるドキュメントは最大 10 件です。上限を超えると、サーバーを再起動するまで以降の呼び出しは失敗します。

サーバーのライセンス設定方法は 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）にリテラル値を記載する方法は、開発者が 1 人の場合に限り許容されます。
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-watermark/watermark-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	従量課金制の秘密鍵。機密情報です。ライセンスを参照してください	（未設定）

Claude Desktop での使用方法

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

特定のバージョンに固定するには、args 内の "GroupDocs.Watermark.Mcp" を "[email protected]" に置き換えてください。予期しないアップグレードを避けるため、共有する設定やコミットする設定ではバージョンを固定することをおすすめします。

VS Code / GitHub Copilot での使用方法

NuGet.org では、パッケージページにすぐに使える mcp.json のスニペットが用意されています。これを .vscode/mcp.json に直接コピーしてください。

または、.vscode/mcp.json に手動で追加してください。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "storage_path",
      "description": "Base folder for input and output files.",
      "password": false
    }
  ],
  "servers": {
    "groupdocs-watermark": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Watermark.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

上記と同じ方法でバージョンを固定できます。特定のリリースに固定するには、"GroupDocs.Watermark.Mcp" を "[email protected]" に置き換えてください。

Docker Compose での使用方法

cd docker
docker compose up

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

ドキュメントとガイド

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

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

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

ライセンス

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