Doc2X MCP：Cherry Studio

返回：Doc2X MCP 使用指南

你需要准备什么

• Node.js（建议 LTS）与 npx
• DOC2X_API_KEY（形如 YOUR_DOC2X_API_KEY）
• （可选）更多 Doc2X MCP 配置（如 DOC2X_BASE_URL / 超时 / 轮询等）：见「Doc2X MCP 使用指南」的“环境变量说明”
• （可选）如果网络不稳定：准备可用的代理或 npm 镜像源

添加 MCP 配置

在 Cherry Studio 的 设置 → MCP 服务器 中配置 doc2x-mcp：

• command：npx
• args：-y @noedgeai-org/doc2x-mcp@0.1.5
• env：DOC2X_API_KEY=YOUR_DOC2X_API_KEY
  • （可选）可按需追加其它环境变量（如 DOC2X_BASE_URL 等），见「Doc2X MCP 使用指南」的“环境变量说明”

查看 MCP

配置完成后，回到 设置 → MCP 服务器：

• 确认 doc2x-mcp 已启用

启用本地文件能力

Doc2X MCP 的 pdf_path 可直接读取该进程可访问的文件；@cherry/filesystem 是客户端选择、列出文件的辅助工具，不是解析 API 的必需参数。只在需要该辅助能力时启用并限制目录：

在对话中启用 doc2x-mcp

使用 doc2x-mcp

• 先在对话里启用 doc2x-mcp

示例提示词：

• 使用 doc2x-mcp 解析我选定的 PDF，并把导出结果保存为 Markdown。

排查思路（常见）

• 依赖安装失败：优先检查网络/代理；其次配置 npm 镜像源；必要时尝试固定版本号。
• 无法读取本地文件：确认已启用 @cherry/filesystem 且目录权限配置覆盖了目标文件路径。
• Key 不生效：确认 MCP server 的环境变量里存在 DOC2X_API_KEY，以及没有被其它配置覆盖。

版本、路径与完成检查

本页按 MCP 0.1.5 配置，截图保留为客户端操作示例，界面文字可能随版本变化。需要 Node.js 18+；先在开放平台取得 API Key。命令中的 YOUR_DOC2X_API_KEY 是占位符，实际值仅写入本机私有配置，不发到对话或版本库。

连接后先核对工具列表包含 doc2x_parse_pdf_submit 与导出/下载工具。给出输入绝对路径和输出目录，授权后只提交一次；保存 uid，等解析成功后再导出。可使用完整提示词与工具步骤。

完成时要求返回实际保存路径，打开下载的文档并核对图片、公式和页序。进度截图不是导出成功证明。超时先续查原 uid；文件路径必须在 MCP 运行主机上可读，输出目录必须可写。真实解析会消耗开放平台额度，服务器“已连接”本身不代表已授权任务。