Doc2x MCP Server
简体中文 | English
本项目提供一个基于 stdio 的 MCP Server，把 Doc2x v2 的 PDF/图片接口封装成语义化 tools。
1) 运行环境
- Node.js >= 18
2) 配置
通过环境变量配置：
DOC2X_API_KEY：必填（形如sk-xxx）DOC2X_BASE_URL：可选，默认https://v2.doc2x.noedgeai.comDOC2X_HTTP_TIMEOUT_MS：可选，默认60000DOC2X_POLL_INTERVAL_MS：可选，默认2000DOC2X_MAX_WAIT_MS：可选，默认600000DOC2X_PARSE_PDF_MAX_OUTPUT_CHARS：可选，默认5000；限制doc2x_parse_pdf_wait_text返回文本的最大字符数，避免大模型上下文超限（设为0表示不限制）DOC2X_PARSE_PDF_MAX_OUTPUT_PAGES：可选，默认10；限制doc2x_parse_pdf_wait_text合并的最大页数（设为0表示不限制）DOC2X_DOWNLOAD_URL_ALLOWLIST：可选，默认".amazonaws.com.cn,.aliyuncs.com,.noedgeai.com"；设为*可允许任意 host（不推荐）
3) 启动
方式 A：通过 npx
{
"command": "npx",
"args": ["-y", "@noedgeai-org/doc2x-mcp@latest"],
"env": {
"DOC2X_API_KEY": "sk-xxx",
"DOC2X_BASE_URL": "https://v2.doc2x.noedgeai.com"
}
}
方式 B：本地源码运行
cd doc2x-mcp
npm install
npm run build
DOC2X_API_KEY=sk-xxx npm start
{
"command": "node",
"args": ["<ABS_PATH>/doc2x-mcp/dist/index.js"],
"env": {
"DOC2X_API_KEY": "sk-xxx",
"DOC2X_BASE_URL": "https://v2.doc2x.noedgeai.com"
}
}
4) Tools
doc2x_parse_pdf_submitdoc2x_parse_pdf_statusdoc2x_parse_pdf_wait_textdoc2x_convert_export_submitdoc2x_convert_export_resultdoc2x_convert_export_waitdoc2x_download_url_to_filedoc2x_parse_image_layout_syncdoc2x_parse_image_layout_submitdoc2x_parse_image_layout_statusdoc2x_parse_image_layout_wait_textdoc2x_materialize_convert_zipdoc2x_debug_config
5) 协议
MIT License，详见 LICENSE。
6) 安装本仓库 Skill（可选）
用于给 Codex CLI / Claude Code 增加一个“教大模型如何使用 doc2x-mcp tools 的 Skill”（便于按固定工作流调用 tools、导出与下载、以及排错）。
不需要 clone 仓库的一键安装（推荐）：
curl -fsSL https://raw.githubusercontent.com/NoEdgeAI/doc2x-mcp/main/scripts/install-skill.sh | sh
重复执行同一条命令即可覆盖安装（默认会覆盖已存在目录）。
在本仓库源码目录安装：
npm run skill:install
默认安装到：
脚本默认安装到：
- Codex CLI：
~/.codex/skills/public/doc2x-mcp（用CODEX_HOME覆盖） - Claude Code：
~/.claude/skills/doc2x-mcp（用CLAUDE_HOME覆盖）
说明：
--target auto（默认）会同时安装到 Codex + Claude；如只想装其中一个，用--target codex|claude。- PowerShell 7+ 一键安装：
irm https://raw.githubusercontent.com/NoEdgeAI/doc2x-mcp/main/scripts/install-skill.ps1 | iex - Windows PowerShell 5.1 一键安装：
irm https://raw.githubusercontent.com/NoEdgeAI/doc2x-mcp/main/scripts/install-skill-winps.ps1 | iex
覆盖安装目录示例：
- mac/linux：
CODEX_HOME=/custom/.codex curl -fsSL https://raw.githubusercontent.com/NoEdgeAI/doc2x-mcp/main/scripts/install-skill.sh | sh -s -- --target codex - Windows：
$env:CODEX_HOME="C:\\path\\.codex"; irm https://raw.githubusercontent.com/NoEdgeAI/doc2x-mcp/main/scripts/install-skill.ps1 | iex