groupdocs-redaction-mcp

GroupDocs.Redaction MCP サーバー

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

インストール

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

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

.NET 10 SDK が必要です。

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

dnx GroupDocs.Redaction.Mcp --yes

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

dnx [email protected] --yes

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

dotnet tool install -g GroupDocs.Redaction.Mcp
groupdocs-redaction-mcp

または、Docker 経由で実行：

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

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

基盤となる GroupDocs エンジンは、画像領域の墨消し（ページ領域に単色のボックスを描画する処理）に System.Drawing（GDI+）を使用します。Linux または macOS でサーバーをネイティブに（dnx またはグローバル dotnet ツール経由で）実行する場合は、まずネイティブの libgdiplus ライブラリをインストールしてください。

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

Linux/macOS でこの手順を省くと、ツールの応答に DllNotFoundException: libgdiplus が表示されます。Linux/macOS で最も手軽にセットアップできる方法は、Docker イメージを使用することです。

利用可能な MCP ツール

ツール	説明
RedactText	ドキュメント内の正規表現パターンに一致するテキストを墨消しします。結果は <name>_redacted.<ext> として保存します
EraseMetadata	ドキュメントのメタデータフィールド（作成者、タイトル、会社、日付、その他のプロパティ）を消去します
RedactAnnotations	ドキュメントの注釈とコメントを置換または削除します
RedactImageArea	ページの矩形領域を単色のボックスで覆います（ピクセル座標）
GetDocumentInfo	ファイル形式、ページ数、サイズ、ページごとの寸法を JSON で返します（変更は行いません）

プロンプトの例

• 「contract.docx 内の『John Smith』をすべて墨消ししてください」
• 「report.pdf を外部と共有する前に、すべてのメタデータを削除してください」
• 「review.docx からすべてのコメントと注釈を削除してください」
• 「agreement.pdf の 1 ページ目にある署名欄を、(100,200) から (400,300) の範囲で黒いボックスで覆ってください」
• 「confidential.pdf は何ページありますか？」

ライセンス

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

• 保存した出力には透かしが入ります。
• 評価モードでは、1 つのサーバープロセスで開けるドキュメントは最大1 件です。墨消しのたびに、新しいサーバープロセスが必要です。

サーバーのライセンス方法は 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 の環境変数に設定し、設定ファイルには一切含めないでください。 標準入出力の 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-redaction/redaction-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-redaction": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Redaction.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

特定のバージョンに固定するには、args 内の "GroupDocs.Redaction.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-redaction": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Redaction.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

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

Docker Compose での使用方法

cd docker
docker compose up

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

ドキュメントとガイド

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

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

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

ライセンス

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