groupdocs-signature-mcp

GroupDocs.Signature MCP サーバー

GroupDocs.Signature を、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.Signature.Mcp --yes

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

dnx [email protected] --yes

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

dotnet tool install -g GroupDocs.Signature.Mcp
groupdocs-signature-mcp

または、Docker 経由で実行：

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

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

内部で使用される GroupDocs エンジンは、System.Drawing（GDI+）を使って文書ページに署名グリフ（テキスト、QR コード、バーコード）を描画します。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、libfontconfig1、ttf-mscorefonts-installer が含まれています。

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

利用可能な MCP ツール

ツール	説明
Sign	テキスト、QR コード、バーコード、またはデジタル証明書の署名を使って文書に署名し、署名済みファイルを <name>_signed.<ext> として保存します
Verify	文書内の署名（テキスト、QR コード、バーコード、デジタル、またはすべて）を検証し、有効性レポートを返します
SearchTextSignatures	埋め込みテキスト署名（スタンプ、ラベル、ネイティブのテキスト注釈）を検索します。部分文字列による絞り込みも指定できます
SearchBarcodes	バーコード署名（Code39、Code128、EAN など）を検索します。デコードされたテキストによる絞り込みや、インライン画像の取得も指定できます
SearchQrCodes	QR コード署名を検索します。デコードされたテキストによる絞り込みや、インライン画像の取得も指定できます
SearchDigitalSignatures	デジタル証明書署名を検索し、署名者、発行者、シリアル番号、有効性ステータスを返します
SearchImageSignatures	埋め込み画像署名（ロゴ、スタンプ画像、画像オーバーレイ）を検索し、base64 PNG として返します
GetDocumentInfo	ファイルの種類、ページ数、サイズ、各ページの寸法を JSON として返します（変更は行いません）

プロンプトの例

• 「contract.pdf に『Signed by Alice』を含む QR コードで署名してください」
• 「agreement.docx 内のすべての署名を検証し、失敗したものがあれば教えてください」
• 「invoice.pdf 内の QR コードを検索し、デコードしたテキストと QR 画像を返してください」
• 「report.pdf にデジタル署名はありますか？ある場合は、誰が署名したか教えてください」
• 「policy.pdf のすべてのページの右下に『APPROVED』というテキスト署名を追加してください」

ライセンス

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

• 操作には評価版の制限が適用され、出力に評価に関する通知が含まれる場合があります。
• 1 つのサーバープロセスで開ける文書は最大15 件です。以降の呼び出しは、サーバーを再起動するまで評価上限エラーで失敗します。

サーバーのライセンス設定方法は 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-signature/signature-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-signature": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Signature.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

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

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

Docker Compose での使用

cd docker
docker compose up

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

ライセンス

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