groupdocs-signature-mcp

GroupDocs.Signature MCP 服务

MCP 服务将 GroupDocs.Signature 作为 AI 可调用工具提供给 Claude、Cursor、GitHub Copilot 和其他 MCP Agent。

安装

一键安装会预填所有受支持的设置：安装后请编辑占位文档文件夹 （输出路径默认与其相同）；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+ 已内置于操作系统中。
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 格式返回文件类型、页数、大小和每页尺寸（不做修改）

示例提示词

• “用包含 ‘Signed by Alice’ 的 QR 码签署 contract.pdf”
• “验证 agreement.docx 中的所有签名，并告知我是否有签名验证失败”
• “在 invoice.pdf 中查找 QR 码——返回解码文本和 QR 图像”
• “report.pdf 中是否有数字签名？如果有，是谁签署的？”
• “在 policy.pdf 每一页的右下角添加文本签名 ‘APPROVED’”

许可

MCP 服务本身采用 MIT 许可证；底层 GroupDocs.Signature 引擎在生产环境中使用需要许可证。如果没有许可证，服务将以评估模式运行：

• 操作会受到评估限制，输出中可能包含评估提示。
• 单个服务进程最多可打开 15 个文档；之后的调用会因评估容量上限而失败，直到服务重启。

服务有两种授权方式。

许可证文件——将 GROUPDOCS_LICENSE_PATH 指向你的 GroupDocs.Total.lic。可离线使用。

计量付费（按使用量付费）——同时设置 GROUPDOCS_METERED_PUBLIC_KEY 和 GROUPDOCS_METERED_PRIVATE_KEY。你只需为实际处理的内容付费，这很适合 AI Agent，因为它们的使用量波动较大，难以提前预测。如果同时配置了计量密钥对和许可证文件，计量模式优先，许可证文件将被忽略。

**计量模式需要出站网络连接。**使用情况会报告给 GroupDocs 服务器，因此，网络隔离或受防火墙保护的部署必须允许出站连接——或者改用许可证文件。

随时调用 get_license_status 工具，查看当前启用的模式，以及计量模式下已消耗的用量和剩余额度。

避免将私钥写入配置

计量私钥属于机密信息。MCP 客户端配置是磁盘上的纯文本文件，而项目级 .mcp.json 通常会提交到版本库，因此请按以下优先顺序处理：

1. 在操作系统环境中设置变量，不要将它们写入配置。 stdio MCP 服务会继承客户端的环境，因此此方法适用于所有客户端。 在 macOS 上请注意，从 Finder 启动的应用不会继承 shell 导出的变量——请使用 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