
Groupdocs Merger Mcp
io.github.groupdocs-merger由 GitHub 账号 groupdocs-merger 发布v26.9.0更新于 Oct 24, 2026
MCP server for GroupDocs.Merger — merge, split, and inspect documents via AI agents.
概览
本地 MCP 服务器,封装 GroupDocs.Merger,让助手合并、拆分和查看 PDF、Office 等文档。
- 可以做什么
- 将 2–4 个文档合并为一个文件并保存到存储目录
- 按指定页面拆分文档,把每页保存为单独文件
- 以 JSON 返回文档类型、页数、大小和每页尺寸,且不修改原文件
- 查询当前授权模式,计量计费下还可查看已用量与剩余额度
- 支持 PDF、DOCX、XLSX、PPTX 及 30 多种文档、图像和压缩包格式
- 适用场景
- 适合让助手在聊天客户端内合并报告或附录、从合同或手册中抽取指定页面,或在处理前先确认文档页数等场景。
- 运行要求
- 以 stdio 本地运行;通过 dnx 或全局 dotnet 工具安装需 .NET 10 SDK,也可改用 Docker。在 Linux/macOS 上原生运行需先安装 libgdiplus。需设置 GROUPDOCS_MCP_STORAGE_PATH(可选 GROUPDOCS_MCP_OUTPUT_PATH)指向文档目录。要解除评估限制需通过 GROUPDOCS_LICENSE_PATH 提供许可证文件,或配置计量密钥对。
安装
在 SourceWeft 中
- 打开 控制台中的 Groupdocs Merger Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
GroupDocs.Merger MCP Server
MCP server that exposes GroupDocs.Merger as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents.
[NuGet] [NuGet downloads] [Docker pulls] [MCP Registry] [Integration tests] [License: MIT]
Installation
[Install in VS Code] [Install in VS Code Insiders] [Add to Cursor] [Codex CLI setup] [Windsurf setup]
One-click installs pre-fill every supported setting: edit the placeholder documents folder after install (output defaults to the same folder); an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode - point it at your license to lift limits.
More clients - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022, Cursor, Windsurf, Cline, and JetBrains Rider live in
install/generated/.
Requires .NET 10 SDK.
Run directly with dnx (recommended — no install step):
Pulls the latest stable release on every invocation. To pin to a specific
version (recommended for shared configs and CI), append @<version>:
Or install as a global dotnet tool:
Or run via Docker:
Native prerequisites
The underlying GroupDocs engine uses System.Drawing (GDI+) for some
operations. When you run the server natively (via dnx or the global
dotnet tool) on Linux or macOS, install the native libgdiplus library first:
Skipping this on Linux/macOS surfaces as DllNotFoundException: libgdiplus in
the tool response. The simplest zero-setup option on Linux/macOS is the
Docker image.
Available MCP Tools
All tools support PDF, DOCX, XLSX, PPTX, and 30+ more document, image, and archive formats.
Example prompts for AI agents
Copy any of these into Claude Desktop, Cursor, or GitHub Copilot Chat after the server is connected.
- Merge documents: "Merge intro.docx and appendix.docx into one file."
- Combine PDFs: "Combine report-q1.pdf, report-q2.pdf, and report-q3.pdf into a single PDF."
- Split out pages: "Split pages 3, 7, and 9 out of contract.pdf into separate files."
- Inspect before merging: "How many pages does presentation.pptx have?"
- Extract a page range: "Pull pages 1 through 5 of manual.docx into their own documents."
Licensing
The MCP server itself is MIT; the underlying GroupDocs.Merger engine requires a license for production use. Without one the server runs in evaluation mode:
- Processed output may carry evaluation watermarks.
- A single server process can open at most 15 documents; further calls fail with an evaluation-cap error until the server restarts.
There are two ways to license the server.
License file — point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic. Works offline.
Metered (pay-per-use) — set both GROUPDOCS_METERED_PUBLIC_KEY and
GROUPDOCS_METERED_PRIVATE_KEY. You are billed for what you actually process, which suits AI
agents well because their usage is bursty and hard to predict up front. If both a metered key pair
and a license file are configured, metered wins and the file is ignored.
Metered mode needs outbound connectivity. Usage is reported to GroupDocs servers, so air-gapped or firewalled deployments must allow that egress — or use a license file instead.
Call the get_license_status tool at any time to see which mode is active, and — under
metered — the consumed quantity and remaining credit.
Keeping the private key out of your config
The metered private key is a secret. MCP client configs are plain files on disk, and a
project-scoped .mcp.json is committed by convention, so prefer, in order:
- Set the variables in your OS environment and leave them out of the config entirely. An
stdio MCP server inherits its client's environment, so this works in every client.
On macOS note that an app launched from Finder does not inherit shell exports — use
launchctl setenv, or launch the client from a terminal. - Reference them indirectly if your client supports it (Claude Code expands
${VAR}; VS Code uses${env:VAR}and${input:...}). - A literal value in a user-scoped config (for example
~/.claude.json) is acceptable for a single developer. - Never commit a literal key in a project-scoped
.mcp.json.
For Docker, forward the values without writing them into any file:
To lift the limits with a license file:
Configuration
Usage with Claude Desktop
To pin: replace
"GroupDocs.Merger.Mcp"with"[email protected]"inargs.
Usage with VS Code / GitHub Copilot
NuGet.org generates a ready-to-use mcp.json snippet on the package page.
Copy it directly into your .vscode/mcp.json.
Alternatively, add manually to .vscode/mcp.json:
Usage with Docker Compose
Edit docker/docker-compose.yml to point volumes at your local documents folder.
Documentation & guides
Step-by-step deployment guides and a published-package integration test suite live in the companion repo GroupDocs.Merger.Mcp.Tests:
- Install from NuGet
- Run via Docker
- Verify on the MCP registry
- Use with Claude Desktop
- Use with VS Code / GitHub Copilot
- Run the integration tests
License
MIT — see LICENSE
来源:README.md,提交 6e1d4a4
工具
0版本历史
1- v26.9.0最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分