GroupDocs.Markdown.Mcp

GroupDocs.Markdown MCP Server

MCP server that exposes GroupDocs.Markdown as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents — convert documents to clean, structured Markdown.

Installation

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):

dnx GroupDocs.Markdown.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.Markdown.Mcp
groupdocs-markdown-mcp

Or run via Docker:

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

No native prerequisites are required on any platform — the underlying GroupDocs.Markdown engine renders image-bearing documents through a self-contained SkiaSharp native asset, so dnx, the global tool, and the Docker image all run with no extra apt/brew setup.

Available MCP Tools

Reverse Markdown → document composition is not yet implemented in the underlying GroupDocs.Markdown 26.3.0 engine (MarkdownConverter.FromMarkdownString throws NotImplementedException), so this server does not expose a ComposeFromMarkdown tool. Use the GroupDocs.Conversion MCP with a .md source file if you need Markdown → DOCX / PDF / HTML output today.

Example prompts for AI agents

• "Convert report.pdf to Markdown"
• "Export business-plan.docx as Markdown with images embedded as base64"
• "Convert pages 1-3 of contract.pdf to Markdown, text only — skip images"
• "How many pages does business-plan.pdf have?"
• "What format and author does cost-analysis.xlsx have?"

Licensing

The MCP server itself is MIT; the underlying GroupDocs.Markdown engine requires a license for production use. Without one the server runs in evaluation mode:

• Output may be limited and carries an evaluation notice.
• A single server process can open at most 15 documents; further calls fail with an evaluation-cap error until the server restarts.

To lift the limits, point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic:

• Get a free 30-day temporary license
• Purchase a license | Product page

Configuration

In evaluation mode (no license) the converted Markdown may be limited and can include an evaluation notice. Supply GROUPDOCS_LICENSE_PATH for unrestricted output.

Usage with Claude Desktop

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

To pin to a specific version, replace "GroupDocs.Markdown.Mcp" with "[email protected]" 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-markdown": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Markdown.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

Same pinning rule as above — swap "GroupDocs.Markdown.Mcp" for "[email protected]" 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.Markdown.Mcp.Tests:

• Install from NuGet — dnx, global tool, pinned vs always-latest
• Run via Docker
• Verify on the MCP registry
• Use with Claude Desktop
• Use with VS Code / GitHub Copilot
• Run the integration 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