Groupdocs Conversion Mcp

io.github.groupdocs-conversion由 GitHub 账号 groupdocs-conversion 发布v26.9.0更新于 Oct 24, 2026

MCP server for GroupDocs.Conversion — convert, inspect, and list supported formats via AI agents.

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

本地 MCP 服务器,让 AI 助手在 70 多种格式之间转换文档、列出可转换的目标格式并查看文件属性。

可以做什么
将文档转换为 PDF、DOCX、XLSX、PPTX、HTML、PNG、JPG 等格式,并把结果保存到存储目录。列出某个源文档可转换成的全部目标格式。读取文档的文件类型、页数、作者、标题、日期以及是否受密码保护。查看当前生效的授权模式,按量计费时还可查看已用量和剩余额度。
适用场景
适合让助手把本地文档转成其他格式,或查看文件类型及其可转换格式,而无需把文件上传到第三方服务。适用于 Claude Desktop、Cursor、VS Code、Rider 等 MCP 客户端的桌面工作流。
运行要求
通过 dnx、全局 dotnet 工具或 Docker 以 stdio 在本地运行;原生运行需要 .NET 10 SDK,Linux/macOS 原生运行还需 libgdiplus。需设置 GROUPDOCS_MCP_STORAGE_PATH 指定输入输出目录,可选 GROUPDOCS_MCP_OUTPUT_PATH。授权可用 GROUPDOCS_LICENSE_PATH,或按量计费的 GROUPDOCS_METERED_PUBLIC_KEY 与 GROUPDOCS_METERED_PRIVATE_KEY。
安装前请注意
未授权时以评估模式运行:输出带水印,单个进程最多打开 15 个文档,之后需重启。按量计费模式按实际处理量收费,并向 GroupDocs 服务器上报用量,需要外网连接。GROUPDOCS_METERED_PRIVATE_KEY 是密钥,不要写入会提交的配置文件。转换会把文件写入配置的存储或输出目录。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Groupdocs Conversion Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

GroupDocs.Conversion MCP Server

Convert PDF, Word, Excel, PowerPoint, HTML, images, and 70+ document formats from Claude, Cursor, GitHub Copilot, and any other MCP agent — locally, your files never leave your machine.

[NuGet] [NuGet downloads] [Docker pulls] [MCP Registry] [Integration tests] [License: MIT]

Install in 60 seconds

[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 the .NET 10 SDK for native runs — or skip straight to Docker.

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

bash
dnx GroupDocs.Conversion.Mcp --yes

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

bash

Claude Desktop

Add to claude_desktop_config.json:

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

To use a license, add "GROUPDOCS_LICENSE_PATH": "/path/to/GroupDocs.Total.lic" to env — omit it to run in evaluation mode.

Claude Code

bash
claude mcp add groupdocs-conversion -- dnx GroupDocs.Conversion.Mcp --yes

VS Code / GitHub Copilot

Use the Install in VS Code button above, or copy the ready-made snippet from the NuGet package page into .vscode/mcp.json, or take install/generated/vscode-mcp.json from this repo.

Visual Studio 2022 (17.14+)

Create .mcp.json in your solution root with the contents of install/generated/vs2022-mcp.json — same shape as VS Code's. This is the native path for .NET teams already in Visual Studio.

Cursor · Windsurf · Cline · Rider · Codex

Docker

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

Images are published to both GHCR (ghcr.io/groupdocs-conversion/conversion-net-mcp) and Docker Hub (groupdocs/conversion-net-mcp) for linux/amd64 + linux/arm64, tagged latest plus an immutable version tag matching each NuGet release (e.g. :26.9.0).

Global dotnet tool

bash
dotnet tool install -g GroupDocs.Conversion.Mcpgroupdocs-conversion-mcp

Version pinning: in any snippet above, replace "GroupDocs.Conversion.Mcp" with "[email protected]" to lock to a specific release. Pinning is recommended for shared / committed configs to avoid surprise upgrades.

Available MCP Tools

ToolDescription
ConvertConverts a document to a different format (PDF, DOCX, XLSX, PPTX, HTML, PNG, JPG, and 70+ more) and saves the result to storage
GetSupportedFormatsLists every target format the source document can be converted to, with primary/secondary indicators
GetDocumentInfoReturns file type, page count, and basic properties (author, title, dates, password-protected) for a source document

Licensing

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

  • Converted output carries an evaluation watermark, and tool responses include an evaluation-mode notice.
  • A single server process can open at most 15 documents; further calls fail with "Could not open more than 15 document files in evaluation mode" 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:

  1. 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.
  2. Reference them indirectly if your client supports it (Claude Code expands ${VAR}; VS Code uses ${env:VAR} and ${input:...}).
  3. A literal value in a user-scoped config (for example ~/.claude.json) is acceptable for a single developer.
  4. Never commit a literal key in a project-scoped .mcp.json.

For Docker, forward the values without writing them into any file:

bash
docker run --rm -i \  -e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \  -v /path/to/documents:/data \  ghcr.io/groupdocs-conversion/conversion-net-mcp:latest

To lift the limits with a license file: commented example in each install snippet above):

Configuration

VariableDescriptionDefault
GROUPDOCS_MCP_STORAGE_PATHBase folder for input and output filescurrent directory
GROUPDOCS_MCP_OUTPUT_PATH(Optional) separate folder for output filesGROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATHPath to GroupDocs license file(evaluation mode)
GROUPDOCS_METERED_PUBLIC_KEYMetered public key. Requires the private key too; takes precedence over the license file(unset)
GROUPDOCS_METERED_PRIVATE_KEYMetered private key. Secret - see Licensing(unset)

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:

PlatformSetup
WindowsNothing — GDI+ is built into the OS.
Linuxsudo apt-get install -y libgdiplus libfontconfig1 ttf-mscorefonts-installer
macOSbrew install mono-libgdiplus
DockerNothing — the image already bundles libgdiplus.

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.

Usage with Docker Compose

bash
cd dockerdocker 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.Conversion.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

来源:README.md,提交 965e94b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v26.9.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分