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 分