给 Claude Desktop / Cursor 配置MinerU MCP Server，对它说"帮我读取这个 PDF"，它就调用 MinerU 解析。
MinerU 是什么
MinerU 是上海人工智能实验室开源的文档解析工具，可以把 PDF、Word、PPT、图片转换成 Markdown、JSON 等结构化格式。
最近团队发布了 MinerU2.5-Pro （2026年4月），在 OmniDocBench v1.6 基准上拿到了 95.69 分 ，刷新生态最好成绩。更难得的是，这个成绩是在 1.2B 参数小体量下达成的，参数量不到同类方案的 1/200，纯靠数据工程驱动。
MinerU 的核心能力：
| 能力 | 说明 |
|---|---|
| 版面分析 | 多栏识别、阅读顺序、页眉页脚过滤 |
| 文本识别 | 109 种语言 OCR |
| 公式识别 | 复杂数学公式转 LaTeX |
| 表格提取 | PDF 表格结构化输出 |
| 图片处理 | 图表、嵌入图像、内容保留 |
没有 GPU？没关系，MinerU 提供云端 API（mineru.net），不用自己部署，直接调用。MCP Server 让 AI 助手直接调用 MinerU，零配置实现"对话即解析"。
什么是 MCP
MCP（Model Context Protocol）是 AI 助手调用外部工具的标准协议。配置好后，Claude/Cursor 等 MCP 兼容的 AI 客户端就能直接调用 MinerU 解析 PDF。
最快启动：uvx（无需安装）
只要你的电脑装了 uv（Python 包管理器），就能直接跑，不需要单独安装 MCP Server：
bash
uvx mineru-open-mcp这条命令会启动 MCP Server，后续在 AI 客户端里配置连接方式即可。
配置 AI 客户端
Claude Desktop（stdio 模式，推荐）
编辑配置文件：
- macOS ：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows ：
%APPDATA%\Claude\claude_desktop_config.json
json
{
"mcpServers": {
"mineru": {
"command": "uvx",
"args": ["mineru-open-mcp"],
"env": {
"MINERU_API_TOKEN": "你的token"
}
}
}
}重启 Claude Desktop，即可使用。
Cursor（stdio 模式）
编辑：~/.cursor/mcp.json（macOS）或 %USERPROFILE%\.cursor\mcp.json（Windows）：
json
{
"mcpServers": {
"mineru": {
"command": "uvx",
"args": ["mineru-open-mcp"],
"env": {
"MINERU_API_TOKEN": "你的token"
}
}
}
}Windsurf（stdio 模式）
配置文件：~/.windsurf/mcp.json
json
{
"mcpServers": {
"mineru": {
"command": "uvx",
"args": ["mineru-open-mcp"],
"env": {
"MINERU_API_TOKEN": "你的token"
}
}
}
}streamable-http 模式（需要自己部署 Server）
启动 Server
bash
MINERU_API_TOKEN=你的token mineru-open-mcp --transport streamable-http --port 8001客户端配置
json
{
"mcpServers": {
"mineru": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8001/mcp"
}
}
}这种模式适合：多个 AI 客户端共享一个 MCP Server，或者需要远程调用时使用。
Flash 模式 vs 精准模式
| Flash（免登录） | 精准（需要 Token） | |
|---|---|---|
| 身份验证 | 无需 Token | 需要 MINERU_API_TOKEN |
| 文件限制 | 20 页 / 10 MB | 600 页 / 200 MB |
| 输出格式 | 仅 Markdown | Markdown + Word + HTML + LaTeX |
| 适用场景 | 快速预览 | 正式使用 |
配置了 MINERU_API_TOKEN 环境变量后，自动切换到精准模式。
可用工具
配置成功后，你可以在 AI 对话中直接调用：
parse_documents
解析本地文件或远程 URL：
bash
请帮我读取 /path/to/document.pdf 的内容
bash
请提取 https://example.com/paper.pdf 的主要内容支持格式：PDF、DOCX、PPTX、JPG、PNG、HTML。
get_ocr_languages
查询 MinerU 支持的 OCR 语言：
bash
MinerU 支持哪些语言的 OCR？环境变量说明
| 变量 | 说明 | 默认值 |
|---|---|---|
MINERU_API_TOKEN |
API Token，精准模式必需 | ---（Flash 模式可选） |
OUTPUT_DIR |
解析结果保存目录 | ~/mineru-downloads |
ENABLE_LOG |
开启日志 | false |
MINERU_LOG_DIR |
日志目录 | ~/.mineru-open-mcp/logs/ |
进阶：日志调试
开启日志：
json
{
"mcpServers": {
"mineru": {
"command": "uvx",
"args": ["mineru-open-mcp"],
"env": {
"MINERU_API_TOKEN": "你的token",
"ENABLE_LOG": "true",
"MINERU_LOG_DIR": "/Users/you/mineru-logs"
}
}
}
}日志文件位置：~/.mineru-open-mcp/logs/log_<timestamp>.txt
相关链接
- MCP Server 完整文档：github.com/opendatalab...
- MCP 协议说明：modelcontextprotocol.io
- Token 申请：mineru.net/apiManage/t...