GroupDocs.Merger.Mcp

GroupDocs.Merger MCP Server

MCP server that exposes GroupDocs.Merger as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents.

Installation

Requires .NET 10 SDK.

Run directly with dnx (recommended — no install step):

dnx GroupDocs.Merger.Mcp --yes

Pulls the latest stable release on every invocation. To pin to a specific version (recommended for shared configs and CI), append @<version>:

dnx [email protected] --yes

Or install as a global dotnet tool:

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

Or run via Docker:

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

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.

1. Merge documents: "Merge intro.docx and appendix.docx into one file."
2. Combine PDFs: "Combine report-q1.pdf, report-q2.pdf, and report-q3.pdf into a single PDF."
3. Split out pages: "Split pages 3, 7, and 9 out of contract.pdf into separate files."
4. Inspect before merging: "How many pages does presentation.pptx have?"
5. Extract a page range: "Pull pages 1 through 5 of manual.docx into their own documents."

Configuration

Usage with Claude Desktop

{
  "mcpServers": {
    "groupdocs-merger": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

To pin: replace "GroupDocs.Merger.Mcp" with "[email protected]" in args.

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:

{
  "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}"
      }
    }
  }
}

Usage with Docker Compose

cd docker
docker compose up

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