groupdocs-merger-mcp

GroupDocs.Merger MCP 服务

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

安装

一键安装会预填所有受支持的设置：安装后请编辑占位的文档文件夹 （输出默认使用同一文件夹）；GROUPDOCS_LICENSE_PATH 为空时将以评估模式运行——将其指向你的许可证即可解除限制。

更多客户端 — Claude Code、Codex CLI、Visual Studio 2022、 Cursor、Windsurf、Cline 和 JetBrains Rider 的现成配置位于 install/generated/ 中。

需要 .NET 10 SDK。

直接使用 dnx 运行（推荐——无需安装）：

dnx GroupDocs.Merger.Mcp --yes

每次调用都会获取最新的稳定版本。若要固定到特定版本（建议用于共享配置和 CI），请追加 @<version>：

dnx [email protected] --yes

或者安装为全局 dotnet 工具：

dotnet tool install -g GroupDocs.Merger.Mcp
groupdocs-merger-mcp

或者通过 Docker 运行：

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

本机运行前提

底层 GroupDocs 引擎会使用 System.Drawing（GDI+）执行某些操作。在 Linux 或 macOS 上本机运行服务（通过 dnx 或全局 dotnet 工具）时，请先安装原生 libgdiplus 库：

平台	设置
Windows	无需操作 — GDI+ 已内置于操作系统。
Linux	sudo apt-get install -y libgdiplus libfontconfig1
macOS	brew install mono-libgdiplus
Docker	无需操作 — 镜像已包含 libgdiplus。

如果在 Linux/macOS 上跳过此步骤，工具响应中会出现 DllNotFoundException: libgdiplus。在 Linux/macOS 上，最简单的零配置选项是 Docker 镜像。

可用的 MCP 工具

工具	描述
Merge	将 2–4 个文档合并为一个文件，并将结果保存到存储中
Split	提取指定页面来拆分文档，并将每页分别保存为单独的文件
GetDocumentInfo	以 JSON 格式返回文档的文件类型、页数、大小和每页尺寸（不修改文档）

所有工具均支持 PDF、DOCX、XLSX、PPTX 以及 30 多种其他文档、图像和存档格式。

AI Agent 提示词示例

连接服务后，将以下任一提示词复制到 Claude Desktop、Cursor 或 GitHub Copilot Chat 中。

1. 合并文档：“将 intro.docx 和 appendix.docx 合并为一个文件。”
2. 合并 PDF：“将 report-q1.pdf、report-q2.pdf 和 report-q3.pdf 合并为一个 PDF。”
3. 提取页面：“从 contract.pdf 中提取第 3、7 和 9 页，分别保存为单独的文件。”
4. 合并前检查：“presentation.pptx 有多少页？”
5. 提取页面范围：“将 manual.docx 的第 1 至 5 页分别提取为单独的文档。”

许可

MCP 服务本身采用 MIT 许可证；底层 GroupDocs.Merger 引擎在生产环境中使用需要许可证。 未提供许可证时，服务将以评估模式运行：

• 处理后的输出可能带有评估水印。
• 单个服务进程最多可打开 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-merger/merger-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-merger": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

如需固定版本：在 args 中将 "GroupDocs.Merger.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-merger": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

使用 Docker Compose

cd docker
docker compose up

编辑 docker/docker-compose.yml，将卷指向本地文档文件夹。

文档和指南

分步部署指南和已发布程序包的集成测试套件位于配套仓库 GroupDocs.Merger.Mcp.Tests：

• 从 NuGet 安装
• 通过 Docker 运行
• 在 MCP 注册表上验证
• 与 Claude Desktop 配合使用
• 与 VS Code / GitHub Copilot 配合使用
• 运行集成测试

许可证

MIT — 请参阅 LICENSE