Doc2X 文档

简体中文

English

简体中文

English

主题

Doc2X MCP：Codex

返回：Doc2X MCP 使用指南

本页以 Codex CLI 为例，演示如何把 Doc2X MCP 作为本地 MCP server 接入，并在对话中调用。

你需要准备什么

  • Node.js（建议 LTS）与 npx
  • DOC2X_API_KEY（形如 YOUR_DOC2X_API_KEY）
  • （可选）更多 Doc2X MCP 配置（如 DOC2X_BASE_URL / 超时 / 轮询等）：见「Doc2X MCP 使用指南」的“环境变量说明”
  • （可选）如需代理：确保 HTTPS_PROXY / HTTP_PROXY 对运行 Codex 的终端生效

添加 MCP 配置

在终端中执行：

shell
codex mcp add doc2x --env DOC2X_API_KEY=YOUR_DOC2X_API_KEY -- npx -y @noedgeai-org/doc2x-mcp@0.1.5

查看 MCP

在 Codex 会话中打开 MCP 列表：

  • 在输入框中输入 /mcp 并回车
  • 或在 UI 中找到 MCP/Tools 列表入口

你应该能看到名为 doc2x 的 MCP server，并且状态为可用。

查看 mcp

使用 doc2x-mcp

  • 把要解析的 PDF 放在当前工作目录（或准备好可被访问的绝对路径）
  • 在对话里明确告诉模型“使用 doc2x MCP 解析并导出”，并给出文件名

示例提示词（按你的文件名替换）：

  • 使用 doc2x-mcp 解析 ./paper.pdf，并导出为 Markdown。

解析导出 PDF

查看导出文档

排查思路（常见）

  • 看不到 doc2x server：确认上面的 codex mcp add ... 命令执行成功，并重新打开/刷新会话。
  • 启动时依赖安装失败：多数是网络/代理问题；可先在终端里确认 npx -y @noedgeai-org/doc2x-mcp@0.1.5 能正常拉取依赖。
  • Key 不生效：确认 --env DOC2X_API_KEY=... 中的值为真实 Key（注意大小写与前后空格）。

版本、路径与完成检查

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

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

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

配置字段与命令请同时参照 Codex 官方 MCP 文档。