Nudocs MCP Server

Nudocs MCP服务器

MCP（模型上下文协议）服务器 Nudocs.ai -文档处理服务 营养素.

特性

此MCP服务器提供以下用于处理Nudocs文档的工具：

• list_文档 -列出所有Nudocs文档
• read_文档 -以Markdown格式读取文档内容
• get_document_access_link -获取文档的可共享访问链接
• 下载_文档 -下载各种格式的文档
• 上传文件 -将文件上传到Nudocs
• 删除文档 -按ID删除文档
• list_top_level_elements -列出带有ID和文本预览的顶级元素
• find_elements_by_text -通过可见文本查找元素ID
• replace_paragraph_text -尽可能在保留内联格式的同时替换段落文本
• insert_paragraph_text -在锚点处插入一个纯文本段落
• insert_table -从纯文本单元格插入表格
• move_element -在目标段落之前或之后移动一个段落/表格
• delete_element -按ID删除一个段落、表格或图像
• set_paragraph_style -设置段落样式(normal、标题、项目符号/编号列表）
• insert_image -在锚点处插入URL中的一个图像

推荐的编辑工作流程

1. 发现ID list_top_level_elements 或 find_elements_by_text.
2. 为您想要的操作应用特定的编辑工具。
3. 验证结果 read_document.

所有编辑工具都使用仅对象有效载荷和简单、LLM友好的输入。

{
  "documentId": "01H...",
  "text": "Anchor paragraph."
}

{
  "documentId": "01H...",
  "id": "p-AAAAAAAAAAAAAAAAAAAAAA",
  "text": "Updated text"
}

{
  "documentId": "01H...",
  "anchorId": "p-AAAAAAAAAAAAAAAAAAAAAA",
  "edge": "end",
  "rows": [
    ["A1", "B1"],
    ["A2", "B2"]
  ]
}

上面的第一个有效载荷是完整的 find_elements_by_text 电话。第二个是a replace_paragraph_text 电话。第三个是A insert_table 电话。

成功的编辑响应包括 summary 加上机器可读元数据： affectedElementIds, idMap，以及 invalidatedSelectors. 如果Nudocs返回冲突(EDIT_CONFLICT)，MCP错误有效载荷包括结构化 最新版本/修订提示等详细信息。

支持的文件格式

输入格式 （上传）：

• Markdown(.md)
• HTML(.html, .xhtml)
• LaTeX(.latex, .tex)
• 重新结构化文本(.rst)
• 组织模式(.org)
• 纺织品(.textile)
• 文档簿XML
• EPUB(.epub)
• MediaWiki(.wiki)
• Jupyter笔记本(.ipynb)
• OpenDocument文本(.odt)
• 微软Word(.doc, .docx)
• 富文本格式(.rtf)
• 纯文本(.txt)
• PDF(.pdf)

输出格式 （下载）：

• Markdown(.md)
• HTML(.html, .xhtml)
• LaTeX(.latex, .tex)
• PDF(.pdf)
• 重新结构化文本(.rst)
• 组织模式(.org)
• 纺织品(.textile)
• 文档簿XML
• EPUB(.epub)
• 微软Word(.doc, .docx)
• OpenDocument文本(.odt)
• 富文本格式(.rtf)
• 纯文本(.txt)
• MediaWiki(.wiki)
• AsciiDoc(.adoc, .asciidoc)
• Jupyter笔记本(.ipynb)

先决条件

• Node.js>=18.0.0
• 带有API密钥的Nudocs帐户(在nudocs.ai注册)

配置

环境变量

设置Nudocs API密钥：

export NUDOCS_API_KEY=your_api_key_here

您可以在Nudocs帐户设置中找到您的API密钥。

整合

克劳德桌面版

将此服务器添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

更新配置后，完全退出并重新启动Claude Desktop。成功连接后，您将在聊天输入的右下角看到一个MCP指示器。

克劳德代码

Claude Code支持三个配置级别：

本地配置（特定于项目）

创建 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

全局配置（所有项目）

创建或编辑 ~/.claude.json:

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用CLI

您还可以使用Claude Code的内置配置向导：

claude mcp add --transport stdio nudocs --env NUDOCS_API_KEY=YOUR_KEY -- npx -y @nutrient-sdk/nudocs-mcp-server

OpenAI Codex

OpenAI Codex通过其CLI和IDE扩展支持MCP服务器。

使用CLI

添加Nudocs MCP服务器的最简单方法：

codex mcp add nudocs --env NUDOCS_API_KEY=YOUR_KEY -- npx -y @nutrient-sdk/nudocs-mcp-server

手动配置

编辑 ~/.codex/config.toml 添加服务器：

[mcp.nudocs]
command = "npx"
args = ["-y", "@nutrient-sdk/nudocs-mcp-server"]

[mcp.nudocs.env]
NUDOCS_API_KEY = "your_api_key_here"

配置文件在Codex CLI和IDE扩展之间共享，因此您只需要配置一次。

有关更多信息，请访问 OpenAI Codex MCP文档.

发展

从源头构建

npm install
npm run build

本地运行

npm run dev

单元测试

npm run test:unit

MCP检验员测试

MCP检查器允许您以交互方式测试服务器：

npm run inspector

问题与支持

报告问题：https://github.com/PSPDFKit/nudocs-mcp-server/issues

许可证

看 许可证 文件以获取详细信息。

______________________________________________________________________

由...制作 营养素 |技术支持： Nudocs.ai