Nutrient Document Engine MCP Server

Nutrient Document Engine MCP 服务

将 AI Agent 接入文档处理。

此 MCP 服务通过自然语言提供文档处理功能，支持直接与用户交互，也支持 AI Agent 调用工具。

我应该使用哪个 MCP 服务？

服务	最适用于	部署方式	核心功能
Nutrient DWS MCP Server	云端文档工作流	Nutrient 托管的 API（API 密钥）	转换、OCR、涂黑、签署、提取、添加水印、自动化
Nutrient Document Engine MCP Server	可自托管的文档工作流	本地部署／私有云	文档处理，并支持部署控制和数据驻留

你现在位于 Document Engine MCP Server 仓库。如果你需要可自托管／本地部署的文档工作流和部署控制，请选择此服务。

• 生态概览：Nutrient AI Infrastructure
• 产品介绍：Nutrient MCP Server

对话示例

配置完成后，你（或你的 Agent）就可以通过自然语言与文档交互：

你： “我有哪些可用文档？”
AI： “我看到你有 3 份文档：annual-report.pdf、contract-draft.pdf 和 tax-form-2023.pdf。你想让我分析其中任何一份吗？”

你： “从这些发票中提取所有姓名和电话号码”
AI： “我找到了 12 位联系人：John Smith（555-0123）、Sarah Johnson（555-0456）……”

你： “涂黑这些税表中的所有社会保障号码”
AI： “我已在 2 份文档中识别并涂黑了 3 个社会保障号码。涂黑后的版本已准备就绪。”

你： “将这份 50 页的合同拆分成独立章节”
AI： “我已将合同拆分为 5 个章节：条款（第 1–8 页）、付款（第 9–15 页）……”

使用 Claude Desktop 进行设置

前提条件

• Claude Desktop - 从 Anthropic 下载。
• Docker Compose - 从 Docker 下载。用于在本地运行 Nutrient Document Engine。
• Node.js 18+ - 此 MCP 服务通过 npx 运行。

许可

Nutrient Document Engine 默认使用评估许可证运行。有关如何移除评估限制，请参阅移除评估水印和限制部分。

1. 启动 Nutrient Document Engine

打开终端窗口，然后运行：

git clone https://github.com/PSPDFKit/nutrient-document-engine-mcp-server.git
cd nutrient-document-engine-mcp-server
docker-compose up -d

2. 连接 Claude Desktop

将以下内容添加到 Claude Desktop 配置中（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "nutrient-document-engine": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/document-engine-mcp-server"],
      "env": {
        "DASHBOARD_USERNAME": "admin",
        "DASHBOARD_PASSWORD": "password",
        "DOCUMENT_ENGINE_BASE_URL": "http://localhost:5000",
        "DOCUMENT_ENGINE_API_AUTH_TOKEN": "secret"
      }
    }
  }
}

3. 重启 Claude Desktop

4. 上传并处理文档

1. 打开网页浏览器并访问 http://localhost:5100/dashboard。
2. 使用拖放界面上传要处理的文档。
3. 切回 Claude Desktop，并提出类似以下问题： “列出我的文档，并从合同中提取文本”

HTTP 传输安全

可选的 HTTP 传输默认绑定到 127.0.0.1。非回环地址的 MCP_HOST 需要设置 MCP_HTTP_AUTH_TOKEN；如果未设置非空令牌，服务将拒绝启动。客户端必须在每个 /mcp 请求中通过 Authorization: Bearer <token> 发送令牌。如果为回环 HTTP 服务设置了令牌，/mcp 同样需要令牌。此令牌不会保护 /health 或 /dashboard；仪表板访问使用 DASHBOARD_USERNAME 和 DASHBOARD_PASSWORD。

# Local-only HTTP transport; no MCP bearer token required.
MCP_TRANSPORT=http npx @nutrient-sdk/document-engine-mcp-server

# Network-accessible HTTP transport; bearer authentication is required.
MCP_TRANSPORT=http MCP_HOST=0.0.0.0 MCP_HTTP_AUTH_TOKEN=replace-with-a-secret \
  npx @nutrient-sdk/document-engine-mcp-server

默认的 stdio 传输保持不变，且始终不需要 MCP_HTTP_AUTH_TOKEN。

功能

此 MCP 服务提供以下领域的文档处理工具：

内容访问：提取文本、搜索文档、将页面渲染为图像、提取表单数据和表格结构。

文档编辑：拆分文档、添加水印、复制文档、填写 PDF 表单。

安全：使用预设模式（SSN、信用卡等）或自定义正则表达式，为敏感数据创建并应用涂黑标注。

注释：添加、读取和删除文档注释，包括高亮、便笺和印章。

系统：文档发现、元数据检索和运行状况监控。

与其他 AI 平台搭配使用

此 MCP 服务可与任何支持 Model Context Protocol 的 AI 平台搭配使用：

• Claude Desktop——使用上述配置快速设置。
• LangGraph——与 LangGraph Agent 集成，构建复杂工作流。
• OpenAI APIs——通过兼容 MCP 的框架连接。
• 自定义 Agent——任何兼容 MCP 的 AI 系统。

示例和文档

示例

• LangGraph 文档处理——合同处理、表单填写和报告生成的工作流示例。
• OpenAI Agents SDK 文档处理——合同处理、表单填写和报告生成的工作流示例。
• 文档聊天界面——使用 React 和 LangGraph 构建的 Web 应用。
• 采购 AI Agent——使用 Langgraph.js 编写的 AI Agent，可将 PO、发票和付款文档分类并汇总到不同组中，并标记出来供人工审核

文档

• 配置指南——环境变量、传输模式和仪表板。
• 功能参考——所有文档处理工具的详细说明。
• 评估框架——测试和基准测试工具。

移除评估水印和限制

Document Engine 默认以评估模式运行，并带有限制。要移除这些限制：

1. 联系销售团队购买许可证：Nutrient
2. 配置许可证：在 Docker Compose 配置 或 Document Engine 设置中设置 ACTIVATION_KEY 环境变量
3. 重启 Document Engine 以应用许可证

有关许可证配置的详细信息，请参阅 Document Engine 许可证指南。

基于服务器的 Document Engine 部署

**本地部署：**按照 Nutrient Document Engine 安装指南操作。

**托管云：**使用托管的 Document Engine 实例——设置指南。

贡献

欢迎贡献！有关开发环境设置、测试指南以及如何提交拉取请求，请参阅 CONTRIBUTING.md。

许可证

MIT 许可证——详情请参阅 LICENSE 文件。