Doc2X MCP：Gemini CLI

返回：Doc2X MCP 使用指南

本页说明如何在 Gemini CLI 中添加 stdio MCP server（Doc2X MCP），以及常见问题排查方式。

你需要准备什么

• Node.js（建议 LTS）与 npx
• DOC2X_API_KEY
• （可选）代理环境变量（HTTPS_PROXY / HTTP_PROXY）

添加 MCP 配置

在终端中执行：

gemini mcp add --transport stdio -e DOC2X_API_KEY=sk-xxx doc2x npx -y @noedgeai-org/doc2x-mcp@latest

查看 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@latest 可用。
• Key 不生效：检查 -e DOC2X_API_KEY=... 是否拼写正确，注意大小写。