Doc2X MCP：Claude Code

返回：Doc2X MCP 使用指南

本页说明如何在 Claude Code 中添加 stdio MCP server，并让会话可调用 Doc2X MCP。

你需要准备什么

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

添加 MCP 配置

在终端中执行：

claude mcp add --transport stdio doc2x -e DOC2X_API_KEY=YOUR_DOC2X_API_KEY -- npx -y @noedgeai-org/doc2x-mcp@0.1.5

查看 MCP

在 Claude Code 中打开 MCP 列表，确认 doc2x server 已加载且可用。

使用 doc2x-mcp

• 确保要解析的文件在当前目录（或使用绝对路径）
• 在对话中明确要求调用 doc2x MCP 来执行解析/导出

示例提示词：

• 请使用 doc2x-mcp 解析 ./paper.pdf 并导出结果。

排查思路（常见）

• server 启动失败：优先检查是否能在终端直接运行 npx -y @noedgeai-org/doc2x-mcp@0.1.5。
• 依赖安装很慢：检查网络/代理；必要时切换 npm 镜像源后重试。
• Key 不生效：确认 -e DOC2X_API_KEY=... 的注入是否生效，并查看 Claude Code 的相关日志输出。

版本、路径与完成检查

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

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

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