营养DWS MCP服务器

这是一个与营养文档网络服务(DWS)处理器API集成的模型上下文协议(MCP)服务器实现，为AI助手提供了强大的PDF处理能力。

此服务器允许AI助手访问由营养DWS处理器API提供的工具，支持操作如数字签名、文档生成、文档编辑、OCR、水印、红字删除等。

目录

• 功能概述
• 使用方法
  • 开始使用Claude Desktop
  • 兼容性
  • 进一步配置
• 贡献

功能概述

功能	描述
文档创建	合并PDF、Office文档和图像
编辑	水印、旋转、展平、红字删除等
格式转换	PDF ⇄ DOCX、图像、PDF/A支持
数字签名	使用可信证书添加符合PAdES标准的数字签名
数据提取	提取文本、表格或结构化内容
安全	红字删除预设、密码保护、权限控制
高级OCR	多语言、图像和扫描识别
优化	无损压缩文件

使用方法

开始使用Claude Desktop + 营养DWS MCP服务器

1. 获取营养DWS API密钥： 在nutrient.io/api注册。
2. 下载Claude Desktop： 如果尚未下载，请下载Claude Desktop并登录。
3. 安装Node.js： 使用像brew这样的包管理器在命令行中安装Node.js。（brew install node）
4. 配置Claude： 在claude_desktop_config.json中添加您的API密钥，并设置您希望用作沙箱的目录（macOS上的路径为~/Library/Application\ Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "nutrient-dws": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/dws-mcp-server", "--sandbox", "/your/sandbox/directory"],
      "env": {
        "NUTRIENT_DWS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

5. 重启Claude Desktop。
6. 添加待处理文档： 使用任何文件管理器将文档复制到上述claude_desktop_config.json文件中设置的沙箱目录。
7. 处理文档： 指导Claude Sonnet 3.7（例如，“从secret.pdf中删除所有PII”，“签署合同.pdf”，“合并secret.pdf和contract.pdf”等）。

注意： 所有操作都涉及磁盘上的读写文件。我们强烈建议使用沙箱目录功能以增强安全性并防止数据丢失。

兼容性

营养DWS MCP服务器已与Claude Desktop（Claude 3.7 Sonnet）进行了测试。其他MCP客户端可能可以工作，但结果可能会有所不同。

目前，营养DWS MCP服务器仅支持macOS。如果您对Windows/Linux的支持感兴趣，请随时打开一个问题。

进一步配置

沙箱模式（推荐）

服务器支持可选的沙箱模式，该模式限制文件操作到特定目录。这对于安全目的非常有用，确保服务器只能读写指定目录内的文件。您应该将要处理的所有文档放入此目录。

启用沙箱模式，使用--sandbox（或-s）命令行参数后跟目录路径：

npx @nutrient-sdk/dws-mcp-server --sandbox /path/to/sandbox/directory

当启用沙箱模式时：

• 对于相对路径，它们相对于沙箱目录解析。
• 在执行任何文件操作之前，验证所有输入文件路径以确保它们存在于沙箱内。

如果未指定沙箱目录，服务器将在没有文件路径限制的情况下运行，允许访问系统上服务器进程有权访问的任何文件。（不推荐）

输出位置

处理过的文件将保存到LLM确定的位置。如果启用了沙箱模式，则它将位于此目录内。

为了进一步指导LLM放置输出文件的位置，可以使用自然语言，如“请将结果输出到output/my_result.pdf”。 或者，您也可以在沙箱中添加一个output目录，提示LLM使用此目录存放所有结果文件。

贡献

请参阅CONTRIBUTING.md中的贡献指南。