Doc2X MCP：Gemini CLI

返回：Doc2X MCP 使用指南

本页说明如何在 Gemini CLI 中添加 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 配置

在终端中执行：

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

查看 MCP

在 Gemini CLI 中打开 MCP 列表，确认 doc2x server 可用。

使用 doc2x-mcp

• 准备 ./paper.pdf（或替换为你的文件路径）
• 在对话中明确要求“使用 doc2x MCP 解析并导出”

示例提示词：

• 使用 doc2x-mcp 解析 ./paper.pdf，并导出结果到当前目录。
• 用 doc2x-mcp 解析 ./paper.pdf，解析完成后给我导出文件名/路径。

排查思路（常见）

• 列表里看不到 server：确认 gemini mcp add ... 执行成功，并在 Gemini CLI 中刷新/重启会话后再查看。
• 启动时卡住或报错：常见原因是依赖下载失败或代理未生效；先在终端验证 npx -y @noedgeai-org/doc2x-mcp@0.1.5 可用。
• Key 不生效：检查 -e DOC2X_API_KEY=... 是否拼写正确，注意大小写。

版本、路径与完成检查

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

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

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