Doc2X MCP 使用指南

本指南介绍如何在不同客户端中接入 Doc2X MCP，并通过 MCP 调用 Doc2X 服务解析 PDF 等文档。

说明：MCP（stdio）本质上是“客户端启动一个本地进程（这里是 npx ...doc2x-mcp），并通过标准输入输出与之通信”。 因此，运行环境的网络/代理、Node.js、以及环境变量注入方式，会直接影响接入是否成功。

前提条件

• 已获取 Doc2X API Key（示例：sk-xxx） 获取地址：open.noedgeai.com
• 已安装 Node.js，并可使用 npx
• 网络可正常访问 Doc2X 服务（请直连国内，国外用户请自行配置代理）

通用 MCP 配置

在支持 MCP（stdio）的客户端中添加如下配置：

{
  "command": "npx",
  "args": ["-y", "@noedgeai-org/doc2x-mcp@latest"],
  "env": {
    "DOC2X_API_KEY": "sk-xxx"
  }
}

环境变量说明

• DOC2X_API_KEY：Doc2X API Key（必填）

常见问题

• 提示找不到 npx

  • 请确认已安装 Node.js（建议 LTS 版本）
  • 重新打开终端或检查 PATH 环境变量

• 依赖安装缓慢或失败

  • 检查网络或代理配置
  • 可切换 npm 镜像源后重试

• API Key 不生效

  • 确认 MCP 启动时已注入 DOC2X_API_KEY
  • 检查客户端日志是否成功读取环境变量

• 不知道怎么写提示词 / 模型没有调用 Doc2X MCP

  请在提示词中 明确说明使用 doc2x-mcp（或 doc2x MCP），并清楚给出：

  • 本地文件的绝对路径,或者相对于当前工作目录的路径。
  • 是否需要导出
  • 导出格式（md / tex / docx）
  • （如需要）保存的目标路径或后续处理要求

  推荐提示词模板（请按你的实际文件名与路径替换，尽量使用绝对路径）：

  • 解析 PDF 并导出为 Markdown / LaTeX / Word

    使用 doc2x-mcp 解析 /abs/path/paper.pdf，并导出为 md|tex|docx（例如 md）。

  • 解析 PDF → 导出 Markdown → 总结要点

    先用 doc2x-mcp 解析 /abs/path/paper.pdf 并导出为 md；
    然后基于导出的内容给我 10 条要点 + 1 段总结。

  • 解析 PDF → 导出 Markdown → 翻译为中文（保留公式/代码）

    用 doc2x-mcp 解析 /abs/path/paper.pdf 并导出为 md；
    再把正文翻译成中文，但保留代码块和数学公式不翻译。

  • 解析 PDF → 导出 Markdown → 生成目录

    用 doc2x-mcp 解析 /abs/path/paper.pdf 并导出为 md；
    然后给我一份按标题层级生成的目录。

  • 解析 PDF → 导出 Markdown → 按一级标题分段输出

    用 doc2x-mcp 解析 /abs/path/paper.pdf 并导出为 md；
    如果内容较长，请按一级标题分段输出，并标注每段对应的标题。

客户端配置指南

• Codex
• Claude Code
• Gemini CLI
• Cherry Studio