Groupdocs Total Mcp

io.github.groupdocs-total由 GitHub 账号 groupdocs-total 发布v26.7.3更新于 Nov 3, 2026

MCP server for GroupDocs.Total — annotate, sign, convert, watermark, parse, redact documents via AI.

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

概览

AI 生成的概览

基于 Docker 的本地 MCP 服务器,提供 GroupDocs 文档工具,让助手对文件进行批注、签名、转换、脱敏、加水印、解析和比较。

可以做什么
  • 检查文档:获取文件类型、页数和大小,并将页面渲染为 PNG 预览
  • 批注:添加、列出、修改、删除批注与回复,导入和导出批注
  • 签名与验证:文本、二维码、条形码、图片和数字证书签名,以及签名搜索
  • 转换与处理:在 50 多种格式间转换,转为 Markdown 或由 Markdown 生成文档,比较两份文档,合并或拆分文件
  • 解析与提取:提取文本、图片、表格、元数据和条形码
  • 脱敏、水印与元数据:按正则脱敏文本、涂黑页面区域、脱敏批注,添加/查找/删除水印,读取或清除元数据
适用场景
适合需要让助手处理本机真实文档文件的场景,例如准备合同签署、把 Office 文件转为 PDF、提取表格或文本、清理元数据,或批量添加水印与脱敏。
运行要求
以本地 Docker 容器方式运行,镜像从 GHCR 拉取(多架构);需安装 Docker 并挂载用于输入输出的主机目录。通过 GROUPDOCS_MCP_STORAGE_PATH 设置基础目录,可选 GROUPDOCS_MCP_OUTPUT_PATH,并用 GROUPDOCS_LICENSE_PATH 指向挂载的 GroupDocs 许可证文件。无许可证时以评估模式运行。
安装前请注意
服务器会写入、修改和删除挂载目录中的文件,包括脱敏、清除元数据和移除水印,建议指向专用目录。需通过 GROUPDOCS_LICENSE_PATH 提供许可证文件路径;无许可证时受评估限制(输出水印、页数限制、每进程可打开文档数上限)。使用数字证书签名需自行提供证书。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

GroupDocs.Total MCP Server

Unified MCP server that exposes the full GroupDocs.Total document-processing toolset — annotation, comparison, conversion, markdown, merging, metadata, parsing, redaction, signing, watermarking, plus cross-product document inspection and page preview — as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents. Designed to be used standalone — attaching the individual product MCPs (GroupDocs.Annotation.Mcp, GroupDocs.Signature.Mcp, …) alongside is unnecessary and would duplicate tools.

[GHCR] [MCP Registry] [Integration tests] [License: MIT]

Installation

[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 host path in the volume mount after install; an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode.

More clients - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022, Cursor, Windsurf, Cline, and JetBrains Rider live in install/generated/.

This product ships via Docker (GHCR) only. GroupDocs.Total bundles every engine (including Parser's embedded ONNX models), so the packed tool far exceeds NuGet.org's 250 MB limit - so dnx and dotnet tool install are not available for it. When upstream ships a slimmer engine that packs under the limit, the standard NuGet flow returns (see the revert notes in .github/workflows/publish_prod.yml).

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

Images are multi-arch (linux/amd64 + linux/arm64), tagged latest plus an immutable version tag per release (e.g. :26.9.0). To pin, replace :latest with the version tag - recommended for shared configs and CI.

Available MCP Tools (38 total)

Tools follow {Product}{Verb}{Noun} PascalCase to disambiguate across domains. Cross-product tools stay short.

Cross-product (2)

ToolDescription
GetDocumentInfoFile type, page count, size as JSON for any document (170+ formats via Parser engine)
GetDocumentPageImageRender up to 5 pages as inline PNG images (Viewer engine, 170+ formats)

Annotation (8)

ToolDescription
AnnotationAddAnnotationAdd textfield / area / point / arrow / highlight / underline / strikeout annotation
AnnotationGetAnnotationsList all annotations as JSON (id, type, message, page, box, user, replies)
AnnotationUpdateAnnotationModify an existing annotation's message and/or bounding box by id
AnnotationRemoveAnnotationsRemove annotations by id list, or all
AnnotationAddReplyAdd a reply / comment thread to an existing annotation
AnnotationRemoveRepliesRemove replies by id, by user name, or all
AnnotationImportAnnotationsImport annotations from XML or another annotated document
AnnotationExportAnnotationsExtract annotations to XML (re-importable via Import)

Signature (7)

ToolDescription
SignatureSignSign with text / qrcode / barcode / digital certificate signature
SignatureVerifyVerify signatures, return JSON validity report
SignatureSearchTextSignaturesFind embedded text signatures with optional substring filter
SignatureSearchBarcodesFind barcode signatures with optional decoded-text filter
SignatureSearchQrCodesFind QR code signatures with optional decoded-text filter
SignatureSearchDigitalSignaturesFind digital certificate signatures (signer, issuer, validity)
SignatureSearchImageSignaturesFind embedded image signatures, return as base64 PNGs

Comparison (1) · Conversion (2) · Markdown (2)

ToolDescription
ComparisonCompareCompare two documents, produce annotated diff document
ConversionConvertConvert between PDF, Office, image, HTML, and 50+ more formats
ConversionGetSupportedFormatsList every output format the document can be converted TO
MarkdownConvertToMarkdownConvert PDF / Office / EPUB / MOBI to clean Markdown
MarkdownComposeFromMarkdownCompose DOCX / PDF / HTML from Markdown source

Merger (2) · Metadata (2)

ToolDescription
MergerMergeCombine up to 4 documents into one (PDF / Office / HTML / images)
MergerSplitSplit a document into separate files by page numbers
MetadataReadMetadataRead all metadata properties (author, title, EXIF, XMP, IPTC, custom) as JSON
MetadataRemoveMetadataStrip all metadata and save a clean copy

Parser (5) · Redaction (4) · Watermark (3)

ToolDescription
ParserExtractTextExtract plain text (page-by-page or whole document)
ParserExtractImagesExtract embedded images and save them to storage
ParserExtractTablesExtract tables as Markdown or JSON
ParserExtractMetadataExtract metadata fields (separate from MetadataReadMetadata; Parser-format-aware)
ParserExtractBarcodesFind and decode embedded barcodes in document pages
RedactionRedactTextRedact text matching a regex with a replacement string
RedactionRedactImageAreaBlack out a rectangular region of a document page
RedactionRedactAnnotationsRedact or delete annotations matching a regex
RedactionEraseMetadataStrip metadata via the Redaction engine (handles formats Metadata can't)
WatermarkAddWatermarkAdd a text watermark with configurable font, rotation, opacity
WatermarkSearchWatermarksList existing watermarks (type, text, position, page) as JSON
WatermarkRemoveWatermarksRemove watermarks by text filter or all

Example prompts

  • "Convert contract.docx to PDF, then sign it with a QR code containing 'Signed by Alice', then watermark every page with 'CONFIDENTIAL'"
  • "Compare old.pdf and new.pdf, list every annotation in the result, and preview page 1"
  • "Extract all tables from report.xlsx as Markdown and redact every email address"
  • "Read the metadata of every PDF in /uploads, then strip it, then preview the cleaned page 1 of each"
  • "Find every barcode in invoice.pdf, then merge invoice.pdf + receipt.pdf into combined.pdf"

Licensing

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

  • Each bundled engine applies its own evaluation limits: output watermarks / evaluation notices, page limits, and per-process document-open caps (1-15 documents depending on the engine).

To lift the limits, mount your GroupDocs.Total.lic into the container and point GROUPDOCS_LICENSE_PATH at it (see the Claude Desktop example 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)

Usage with Claude Desktop

json
{  "mcpServers": {    "groupdocs-total": {      "command": "docker",      "args": ["run", "--rm", "-i", "-v", "/path/to/documents:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]    }  }}

To use a license, add "-v", "/path/to/license-folder:/license", "-e", "GROUPDOCS_LICENSE_PATH=/license/GroupDocs.Total.lic" before the image name. To pin a version, replace :latest with the release tag.

Usage with VS Code / GitHub Copilot

Use the Install in VS Code button above, or add to .vscode/mcp.json (also in install/generated/vscode-mcp.json):

json
{  "inputs": [    {      "type": "promptString",      "id": "storage_path",      "description": "Base folder for input and output files.",      "password": false    }  ],  "servers": {    "groupdocs-total": {      "command": "docker",      "args": ["run", "--rm", "-i", "-v", "${input:storage_path}:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]    }  }}

Usage with Docker Compose

bash
cd dockerdocker compose up

Edit docker/docker-compose.yml to point volumes at your local documents folder.

License

MIT — see LICENSE

来源:README.md,提交 96dde17

工具

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

版本历史

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

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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