GroupDocs.Comparison.Mcp 26.5.2

Prefix Reserved
{
  "inputs": [
    {
      "type": "promptString",
      "id": "storage_path",
      "description": "Base folder for input and output files. Defaults to the current working directory.",
      "password": false
    },
    {
      "type": "promptString",
      "id": "output_path",
      "description": "Optional — separate folder for output files. Defaults to GROUPDOCS_MCP_STORAGE_PATH.",
      "password": false
    },
    {
      "type": "promptString",
      "id": "license_path",
      "description": "Path to the GroupDocs.Total.lic license file. Omit to run in evaluation mode.",
      "password": false
    }
  ],
  "servers": {
    "groupdocs.comparison.mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["groupdocs.comparison.mcp@26.5.2", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}",
        "GROUPDOCS_MCP_OUTPUT_PATH": "${input:output_path}",
        "GROUPDOCS_LICENSE_PATH": "${input:license_path}"
      }
    }
  }
}
                    
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file.
dotnet tool install --global GroupDocs.Comparison.Mcp --version 26.5.2
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local GroupDocs.Comparison.Mcp --version 26.5.2
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=GroupDocs.Comparison.Mcp&version=26.5.2
                    
nuke :add-package GroupDocs.Comparison.Mcp --version 26.5.2
                    

GroupDocs.Comparison MCP Server

MCP server that exposes GroupDocs.Comparison 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.Comparison.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 GroupDocs.Comparison.Mcp@26.5.2 --yes

Or install as a global dotnet tool:

dotnet tool install -g GroupDocs.Comparison.Mcp
groupdocs-comparison-mcp

Or run via Docker:

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

Available MCP Tools

Tool Description
Compare Compares two documents (source vs target) and produces a marked-up result file plus a change-count summary. Supports PDF, Word, Excel, PowerPoint, ODT, RTF, TXT, HTML, and 30+ more formats; optional sourcePassword / targetPassword cover protected documents.
GetDocumentInfo Inspects a single source document and returns file type, page count, file size, and per-page dimensions as JSON — without performing a comparison. Useful as a pre-flight check before deciding whether to compare or which formats to expect. Optional password for protected documents.

Example prompts for AI agents

Once the server is wired up to your MCP client (Claude Desktop, Cursor, VS Code Copilot, …), try:

Compare old.pdf and new.pdf — what changed?

Diff contract-v1.docx against contract-v2.docx and tell me the change count.

Show the differences between budget-q1.xlsx and budget-q2.xlsx.

How many pages does report.pdf have? Who's the author?

Inspect /docs/legal-brief.pdf — what's the file type and page count?

The client picks Compare for diff questions and GetDocumentInfo for inspection-only questions.

Configuration

Variable Description Default
GROUPDOCS_MCP_STORAGE_PATH Base folder for input and output files current directory
GROUPDOCS_MCP_OUTPUT_PATH (Optional) separate folder for output files GROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATH Path to GroupDocs license file (evaluation mode)

Usage with Claude Desktop

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

To pin to a specific version, replace "GroupDocs.Comparison.Mcp" with "GroupDocs.Comparison.Mcp@26.5.2" in args. Pinning is recommended for shared / committed configs to avoid surprise upgrades.

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-comparison": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Comparison.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

Same pinning rule as above — swap "GroupDocs.Comparison.Mcp" for "GroupDocs.Comparison.Mcp@26.5.2" to lock to a specific release.

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.Comparison.Mcp.Tests:

That repo also exercises every advertised tool against the published NuGet artifact on Linux, macOS, and Windows in CI — so the snippets above are verified end-to-end on every release.

License

MIT — see LICENSE

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
26.5.2 183 5/17/2026
26.5.1 162 5/3/2026
26.5.0 106 5/3/2026