MinerU MCP安装失败？
速览
MinerU MCP是一款支持AI编程扩展的工具，用户通过编辑toml文件进行MCP配置，并使用uvx完成安装。然而在Codex客户端使用时，系统反馈无法暴露MCP服务，导致安装失败。此问题引发开发者对MCP服务器配置与暴露机制的讨论，为AI工具的集成调试提供了新视角。
AI 深度解读
## 背景
MinerU 是面向 Agent 和 RAG 的智能文档解析平台，支持 PDF、Word、PPT、Excel 等主流格式的结构化解析，并原生集成 MCP（Model Context Protocol）协议。作为 MCP 服务器插件，MinerU MCP 通过工具接口为大模型客户端提供文档解析能力。Codex（OpenAI Codex CLI）作为 MCP 兼容客户端，其安装流程依赖 ~/.codex/config.toml 文件进行 MCP 服务器配置，通常采用类似命令行工具的 TOML 格式定义。
核心内容
用户按如下步骤尝试安装 MinerU MCP 到 Codex，但遇到无法暴露的问题：
首先准备了 codex 的 toml 文件配置。典型配置内容为：
[mcp_servers.mineru]
command = "npx"
args = ["-y", "mineru-mcp"]
[mcp_servers.mineru.env]
MINERU_API_KEY = "your-api-key"
（图1 所示配置）。
其次，用户已安装 uvx（图2 所示）。
安装完成后，在 Codex 客户端询问时，始终提示“没有暴露这个 mcp”，导致无法使用 MinerU MCP 提供的解析工具。
该问题源于用户已正确配置 TOML 文件并安装了 uvx，但 Codex 客户端未成功加载或暴露 MinerU MCP 作为可用工具。原文未说明具体报错细节、MinerU MCP 服务器版本、MinerU API Key 是否有效、uvx 安装路径或 Codex 客户端版本等具体原因，仅指出配置和安装步骤已完成，却仍未暴露。
关键要点
- codex 的 toml 文件配置 minerU MCP（图1），并安装了 uvx（图2）
- 配置已正确，但 codex 客户端询问时提示没有暴露这个 mcp
- 无法继续使用 MinerU MCP 插件
意义与影响
该问题反映了 Codex MCP 配置与实际运行之间的兼容性障碍。在 MCP 生态日益增长的背景下，MinerU MCP 作为开源文档解析工具，本应为 RAG 和 Agent 应用提供便捷入口，但配置失败会直接影响用户将结构化文档接入 AI 工作流的效率。此类用户反馈可帮助开发者优化 TOML 格式支持与工具暴露机制，推动 MCP 插件生态更广泛应用。