# MinerU

将 PDF、Office、图片与网页解析为 Markdown 和结构化数据。

- 类型：MCP · Skill · CLI
- 权限：可执行操作
- 门槛：免费可用、需 API Key
- 官方入口：https://github.com/opendatalab/MinerU-Ecosystem
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/mineru/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需 uv；标准解析需本人平台 API Token，Flash 轻量路径有独立限制。普通成员在企业账号下能否自行创建 Token、管理员开通范围及企业版要求，所引官方生态仓库未说明。文件大小、页数及额度以所选路径当前文档为准。

## 接入步骤

1. 按生态仓库的 MCP 入口阅读对应配置，先确定标准或轻量解析路径。 [官方入口](https://github.com/opendatalab/MinerU-Ecosystem)
2. 添加下方本地 MCP 配置；标准路径按文档在本地配置 Token，勿把 Flash 限制套到标准解析。 [官方入口](https://github.com/opendatalab/MinerU-Ecosystem)

## 验证方法

先列出工具，再按额度许可用公开的小 PDF 验证输出 Markdown；不上传私人文档。

指引核对于 2026-11-05，不是本项目实测结果。

权限依据：[官方页面](https://github.com/opendatalab/MinerU-Ecosystem)

官方原文：Default is mode="flash" (no API token required).

## 费用

官方 Flash 路径无需 API Key、免费，单文件最多 20 页和 10 MB；标准解析的额度和费用按平台规则确认。 [官方来源](https://github.com/opendatalab/MinerU-Ecosystem)（核对日期：2026-11-05）

官方原文：Flash mode works out of the box, free, up to 20 pages / 10 MB per file.

## 安装配置

### JSON

```
{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ]
    }
  }
}
```

### Claude Code

```
claude mcp add --transport stdio 'mineru' -- 'uvx' 'mineru-open-mcp'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.mineru]
command = "uvx"
args = ["mineru-open-mcp"]
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

- [官方 Skill](https://github.com/opendatalab/MinerU-Ecosystem/tree/main/skills)

## 核验与来源

2026-11-05 核对官方身份：[依据](https://github.com/opendatalab/MinerU-Ecosystem)。OpenDataLab 官方组织主页链接 opendatalab.org.cn，仓库提供 MCP、CLI 与 Skills。

官方原文摘录（2026-11-05，来自上述依据）：

```
mineru-open-mcp
```

- [厂商官方接入文档](https://github.com/opendatalab/MinerU-Ecosystem)
- [厂商官方发布依据](https://github.com/opendatalab)
- [官方账号与权限说明](https://github.com/opendatalab/MinerU-Ecosystem)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)