A side-by-side look at the MinerU Open MCP and MinerU Ecosystem MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose MinerU Open MCP for search & data extraction work as a local process; choose MinerU Ecosystem for search & data extraction as a local process. You can also run both side by side in one mcpServers block.
parse_documents, get_ocr_languages.MINERUAPITOKEN.parse_documents, get_ocr_languages.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Search & Data Extraction | Search & Data Extraction |
| Quality signal | 61/100 · Good | 64/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | API key required |
| Pricing | Not declared | Free |
| Required env vars | None listed | MINERUAPITOKEN |
| Verified owner | Community listing | Community listing |
| GitHub stars | 222 | 220 |
| Directory activity | 2 views 0 installs 0 upvotes | 3 views 0 installs 0 upvotes |
| Tools | 2 | 2 |
| Full listing | View MinerU Open MCP | View MinerU Ecosystem |
parse_documentsConvert PDF, Office (DOCX, PPTX), spreadsheets (XLSX in Flash mode), images, and http(s) URLs to Markdown using the MinerU cloud API (content is uploaded to mineru.net; do not use for data that must stay on-device). Does not modify source files; may write Markdown under output_dir when saving results.
Auth: without MINERU_API_TOKEN, Flash mode applies (Markdown-only, about 20 pages and 10 MB per file; service rate limits). With MINERU_API_TOKEN, higher limits and optional formats per plan.
Use for extraction and conversion. Use get_ocr_languages only to list OCR language codes, not to parse files. Not for fully offline parsing.
Parameters: file_sources is paths/URLs or objects with source and pages for PDF ranges; language is an OCR code (default ch); enable_ocr defaults to auto (null); set model to html only if every source is a web page URL.get_ocr_languagesReturn supported MinerU OCR and script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting the language argument on parse_documents for scanned or multilingual documents. Do not use for file conversion; call parse_documents instead.parse_documentsConvert PDFs, Word (DOCX), PowerPoint (PPTX), Excel (XLSX in Flash mode), images, and public document URLs—or HTML page URLs—into Markdown using the MinerU cloud API.
**World effects:** Reads local paths you pass; fetches http(s) URLs. Uploads file or URL content to mineru.net for processing (do not use for data you must not send off-device). Does not modify or delete originals. May write Markdown (and sometimes images) under `output_dir` or the server default when results are saved or inline content is too large.
**Auth & limits:** Without `MINERU_API_TOKEN`, uses free Flash mode: Markdown-only output, service limits apply. With `MINERU_API_TOKEN`, higher per-file page limits and optional extra output formats per MinerU plans; token is read from env (or HTTP Bearer when using streamable HTTP).
**Use this when:** The user needs full-document extraction, tables/formulas as HTML/Latexa, batch conversion, or per-file PDF page ranges. **Do not use** for listing supported OCR script codes—call `get_ocr_languages` instead. **Not a substitute** for offline-only or strictly local parsers.
**Parameters (intent):** `file_sources` is a list of path/URL strings or `{"source": "…", "pages": "1-5"}` objects (PDF page ranges; Flash allows simple `N` or `N-M`). `enable_ocr` defaults to true. `language` is an OCR/script code (default `ch`); see `get_ocr_languages` for valid values. Set `model` to `"html"` only when every source is a web page URL; otherwise omit. `output_dir` overrides where large or batch results are written.get_ocr_languagesReturn the supported MinerU OCR / script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting `language` on `parse_documents` for scanned or multilingual documents. Do not use for converting files—call `parse_documents` instead.Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
{
"mcpServers": {
"mineru-open-mcp": {
"command": "uvx",
"args": [
"mineru-open-mcp"
]
}
}
}
{
"mcpServers": {
"opendatalab-mineru-ecosystem": {
"command": "uvx",
"args": [
"mineru-open-mcp"
],
"env": {
"MINERUAPITOKEN": "YOUR_MINERUAPITOKEN_HERE"
}
}
}
}