A GroupDocs MCP 服务器让 Claude Desktop、Claude Code、Cursor、GitHub Copilot 和其他 MCP 客户端能够 本地 处理您的文档：客户端在您自己的机器上将服务器作为子进程启动，文件在您选择的文件夹中读取和写入。每个产品的本地部署页面上都有完整的架构和安全模型文档，例如 Running GroupDocs MCP servers on-premise: architecture and security model。本文比较了连接 AI 代理与文档的三种常见方式，并解释了哪些会离开机器，哪些不会。

哪些架构可以将 AI 代理连接到文档？

有三种。它们的区别在于安全审查员首先会问的一个问题：文档会去哪里？

云上传 托管 API 本地 MCP 服务器
工作原理 助手或插件将文件上传到供应商服务 您的代码或代理调用带有文件的供应商 REST API AI 客户端在您的机器上启动服务器进程
文档去向 第三方云 第三方云或您自己的租户 无处：从本地文件夹读取并写入
网络暴露面 向供应商的出站请求 向供应商的出站请求 仅 stdio；使用许可证文件时仅有使用报告（无文档内容）的计量授权
入站端口 不适用 不适用 无
空气隔离使用 不可能 通常不行；取决于供应商的部署选项 使用许可证文件时可行
谁来运行 供应商 供应商 您，作为 AI 客户端的一部分

第三列展示了 GroupDocs MCP 服务器实现的内容。本文其余部分将介绍其工作方式以及限制所在。

本地 MCP 服务器的数据流是什么样的？

AI 客户端将服务器作为子进程启动，并通过标准输入输出使用 JSON‑RPC 与其通信。服务器从不监听网络端口，并且在使用许可证文件时也不会发起出站连接。

+--------------+          +--------------------+         +------------------+
|  AI client   |  stdio   | MCP server process | reads / | local filesystem |
| (Claude,     | <------> | (GroupDocs engine) | <-----> | storage / output |
|  Cursor, ..) | JSON-RPC |   child process    |  writes |     folders      |
+--------------+          +--------------------+         +------------------+
       |
       | prompts and quoted fragments only
       v
+--------------------+
|   model provider   |  (cloud, or a local model inside your network)
+--------------------+

安全审查员可以检查以下四条声明：

  • 传输方式： 标准输入输出到子进程。没有需要防火墙的内容，也没有需要暴露的内容。
  • 入站端口： 无。
  • 遥测： 无。文档引擎在进程内运行。
  • 网络使用： 仅在安装时从 nuget.org 拉取包或从 ghcr.io 拉取镜像。运行时服务器不进行任何出站调用，唯一的例外是下面描述的授权情况。

您可以自行验证，而不是盲目信任：运行任务并监视监听套接字和出站连接。

当代理处理文档时，哪些内容会离开机器？

文档本身不会离开机器。提示和引用的片段会离开。

您的 AI 客户端背后的模型会看到整个对话。如果模型是云托管的，您的指令文本会发送给模型提供商，您引用回来的任何内容也会一起发送。两个示例：

  • 在一次比较后，代理报告付款条款从 30 天改为 45 天。该句子是对话的一部分，会传递给提供商。
  • 在一次提取后，代理报告发票总额。文件没有移动，但该数值会被发送。

一个有用的习惯是将提示措辞为让答案携带更少内容，例如询问“哪些文件的总额超过阈值”，而不是直接请求所有总额。对于敏感语料库，建议将服务器与本地托管的模型配合使用。这样整个循环（客户端、模型、服务器、文件）都保持在您的网络内部。

本地服务器是否需要互联网访问？

处理过程本身不需要。是否需要取决于授权模式：

  • 许可证文件： 由本地进程从本地磁盘读取。完全离线工作，是空气隔离网络的正确选择。
  • 计量（按使用付费）： 服务器会向 GroupDocs 上报 使用情况，因此需要出站流量。报告不包含文档内容，但该连接本身必须被防火墙允许。

如果同时配置了计量密钥和许可证文件，计量密钥优先。请将密钥存放在环境变量中，而不是提交到配置文件。每个产品的授权页面都有相应的设置说明，get_license_status 工具会报告当前激活的模式。

如何使用 Docker 在防火墙内部运行服务器？

对于平台团队来说，Docker 镜像通常是更简便的选项：一个包含本机依赖的镜像，主机上无需 SDK，边界仅限于您挂载的文件夹。每个产品都有自己的镜像，命名为 ghcr.io/groupdocs-<product>/<product>-net-mcp。下面的命令展示了单个产品的基本形态，请自行替换占位符。

docker run --rm -i \
  -v /srv/documents:/data \
  -v /srv/licenses:/license:ro \
  -e GROUPDOCS_MCP_STORAGE_PATH=/data \
  -e GROUPDOCS_LICENSE_PATH=/license/GroupDocs.<Product>.lic \
  ghcr.io/groupdocs-<product>/<product>-net-mcp:<tag>
  • 固定标签。 快速入门命令使用 :latest；在生产环境中，请将标签锁定到您已测试的版本，以防重建后行为改变。
  • 有意挂载。 容器只能看到您提供的文件夹，这比以您用户身份运行的进程提供了更严格的边界。
  • 只读挂载许可证。
  • 空气隔离环境： 预先拉取镜像或预缓存 NuGet 包，并锁定版本。

您的 AI 客户端将在其 MCP 配置中将上述 docker run 命令作为服务器命令执行，因此容器即为上图中的子进程。文档说明这些镜像是多架构的（linux/amd64 和 linux/arm64）。

本地 MCP 服务器适用于受监管行业吗？

它消除了隐私审查中最大的疑问——文档向第三方处理者的转移。法律、金融、医疗保健和公共部门等政策禁止上传文档的团队可以将其作为构建 HIPAA 或 GDPR 工作流的基石。这里仅描述架构适用性。GroupDocs MCP 服务器本身未获得任何法规认证，您的合规义务仍取决于所配合的模型、授权模式以及您自己的控制措施。

该模型的限制有哪些？

  • 一个服务器服务一个客户端进程。 stdio 服务器由单个客户端在单台机器上启动，非多用户服务。若需共享服务，请在 GroupDocs 库前自行搭建服务，而不是运行多个 MCP 服务器。
  • 计量授权需要出站。 如上所述，会发送使用报告。如网络必须封闭，请使用许可证文件。
  • 提示仍会发送到模型提供商，除非您使用本地托管的模型。
  • 评估模式有局限。 没有许可证时，服务器以评估模式运行，受产品特定限制。例如，Comparison 服务器仅比较前 2 页并添加水印。请先调用 get_license_status 并阅读相应产品的授权页面。
  • Parser 和 Search 仅以 Docker 镜像形式提供。 GroupDocs.Parser.Mcp 和 GroupDocs.Search.Mcp 没有 NuGet 包，因此只能通过上述 Docker 方式使用。在 Linux 主机上运行其容器时，请使用 --user "$(id -u):$(id -g)" 以便写入您挂载的文件夹。
  • 平台例外。 两个 PDF 专用操作目前在 Linux（包括 Docker 镜像）上会失败，因为 PDF 引擎的图像处理依赖 System.Drawing.Common，而 .NET 仅在 Windows 上支持：GroupDocs.Annotation.Mcp 的 generate_pages_preview 在 PDF 文件上（Word 文档渲染正常），以及 GroupDocs.Redaction.Mcp 的 redact_image_area 和 erase_metadata 在 PDF 文件上（redact_text 在 PDF 上以及上述三个在 Word 文档上均可工作）。请在 Windows 上使用 dnx 运行这些功能；详见各产品帖子。

FAQ

MCP 对敏感文档安全吗？
使用 GroupDocs MCP 服务器时，文档在本机通过 stdio 进程内处理，没有监听端口，也没有遥测。需要评估的只有您的 AI 客户端使用的模型，因为提示和引用的片段会发送到模型提供商。

我可以在不将数据发送到云的情况下运行 Claude 工具吗？
文档始终本地保存。若希望提示也保持本地，请使用支持本地托管模型的客户端，这样对话的任何部分都不会离开您的网络。

MCP 服务器会发送哪些数据？
在使用许可证文件时，运行时 GroupDocs MCP 服务器不会通过网络发送任何内容。使用计量授权时，仅会向 GroupDocs 发送使用报告，绝不包含文档内容。

每个产品：文档中的本地部署页面

每个页面都涵盖相同的架构以及该产品的命令。这些是安全审查的权威参考。

每个产品：博客入门指南

每个产品都有一系列文章——大多数四篇，Search 为六篇。第一篇解释模式，其余文章则进行实际应用。