Mineru Open Mcp

MinerU Open MCP

MinerU 官方 MCP 服务，将 MinerU 的文档解析功能作为 MCP 工具提供。连接任何兼容 MCP 的 AI 客户端，即可将 PDF、Word 文档、PowerPoint 文件和图像转换为 Markdown。

无需 API 密钥——Flash 模式开箱即用，无需注册即可免费使用，但限制较低。设置 MINERU_API_TOKEN 可解锁更高的使用限额和更多输出格式。

带沙盒的 MCP 客户端注意事项 - 对于某些 MCP 客户端，拖入输入框的文件会被沙盒隔离到临时目录中。如果需要上传并解析本地文件，请在提示词中提供目标文件的完整路径，以防服务无法找到文件。

---

⚡ 最快运行方式 — uvx（无需安装）

mineru-open-mcp 已发布到 PyPI。安装 uv 后，即可直接运行，无需单独安装。

配置 MCP 客户端

stdio — Claude Desktop、Cursor、Windsurf

MCP 客户端会自动将 mineru-open-mcp 作为子进程启动。

使用 uvx（推荐——始终运行最新版本）：

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": ["mineru-open-mcp"],
      "env": {
        "MINERU_API_TOKEN": "your_key_here"
      }
    }
  }
}

没有 API 密钥？ 服务会以 Flash 模式运行——免费且仅输出 Markdown，了解更多信息请参阅 Flash Mode Docs

mineru-open-mcp 不在 PATH 中？ 请使用完整路径："/Users/you/.local/bin/mineru-open-mcp"，或者使用上面的 uvx 方式，它会自动处理。

使用示例

示例 1：解析指定页码范围的本地 PDF 文档

用户提示词：“将此 PDF 的第 3-5 页解析为 Markdown：<your_path_to_file>” 执行过程：

• MinerU 上传并解析 PDF
• 返回格式清晰的 Markdown，并保留表格（HTML）和公式（Latex）
• 如果长度允许，会在聊天中返回 Markdown 文本以及输出路径；如果你更喜欢，也可以返回 zip URL
• MCP 客户端总结内容

示例 2：解析托管文件的远程 URL

用户提示词：“提取这篇论文的内容：https://arxiv.org/pdf/2509.22186” 执行过程：

• MinerU 将论文解析为 Markdown
• MCP 客户端整理并说明表格

示例 3： 解析带有独立页码范围的本地 PDF 文件

用户提示词：“将 <file1> 的第 1-5 页、<file2> 的第 2-9 页、<file3> 的第 3 页解析为 Markdown” 执行过程：

• MinerU 分别上传并解析这些文件
• 返回目标格式的输出、供你下载的 zip URL、Markdown 摘要，以及你想要保存输出的目录
• MCP 客户端使用内容进行进一步分析

示例 4：高级自定义偏好

用户提示词 1：“使用 pipeline 模型解析这个韩语文件 your_path_here” 用户提示词 2：“解析 your_path_here，并将 Markdown 保存到 your_output_dir” 执行过程：

• Pipeline 模型是 MinerU 服务提供的另一种模型（顺便一提，默认使用 vlm 模型）
• 你可以通过组织提示词来指定模型、OCR 语言，甚至指定不同于 OUTPUT_DIR 的独立输出目录
• 你的请求会被转换为 parse_documents 工具的参数，其余工作由 MinerU 处理。

streamable-http — 基于 Web 的 MCP 客户端

手动启动服务，然后将客户端指向该服务：

MINERU_API_TOKEN=your_key mineru-open-mcp --transport streamable-http --port 8001

{
  "mcpServers": {
    "mineru": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8001/mcp"
    }
  }
}

功能

• parse_documents？将本地文件和/或远程 URL 转换为 Markdown；支持输入 PDF、图片（png/jpg/jpeg/jp2/webp/gif/bmp）、Doc、Docx、Ppt、PPTx。Flash 模式还支持 xlsx。
• get_ocr_languages — 列出 MinerU 支持的所有 OCR 语言
• Flash 模式 — 无需 API 密钥即可使用（免费，仅输出 Markdown，支持 PDF/图片/Docx/PPTx/xls/xlsx）；如需使用完整功能，请提供 MINERU_API_TOKEN，这将停用 Flash 模式。
• 输出行为？单文件解析默认以内联 Markdown 返回；批量解析会将结果保存到磁盘并返回文件元数据。超大的内联内容也会保存到本地，并通过 extract_path 返回。
• 两种传输模式？stdio、streamable-http

---

环境变量

变量	描述	默认值
MINERU_API_TOKEN	MinerU API 令牌；如需使用完整功能，请在 MinerU 申请。如果未提供，则启用 Flash 模式。	—
OUTPUT_DIR	需要在本地保存解析结果时使用的目录，例如批量解析或超大内联内容	~/mineru-downloads

隐私政策

mineru-open-mcp 连接官方 MinerU API（mineru.net）以解析文档。

• 发送的数据：文档内容（你提供用于解析的文件或 URL）
• 数据存储：解析结果会由 MinerU 服务临时缓存；不会用于训练
• 第三方：MinerU API（mineru.net）— 请参阅 OpenDatalab 隐私政策
• 本地数据：解析结果将保存到目标输出目录。日志文件（仅当 ENABLE_LOG=true 时）会保存到 MINERU_LOG_DIR；
• 联系方式：[email protected]（或在 MinerU-Ecosystem 提交问题）