Mineru MCP vs MinerU Ecosystem — MCP Server Comparison | AllMCPs
Side-by-Side Model Context Protocol Comparison
Mineru MCP vs MinerU Ecosystem
In-depth architectural comparison of the Mineru MCP and MinerU Ecosystem MCP servers. Compare execution transports, security boundaries, tool capabilities, quality scores, and ready-to-paste client installation snippets for Claude, Cursor, Windsurf, and VS Code.
At a Glance & Executive Verdict
Mineru MCP
Search & Data Extraction · Local stdio
Quality: 60/100 (Good) | Auth: API Key required
MinerU Ecosystem
Search & Data Extraction · Local stdio
Quality: 64/100 (Good) | Auth: API Key required
Verdict Summary: Choose Mineru MCP if you need specialized Search & Data Extraction tools running via a local process. Choose MinerU Ecosystem if your workspace requires Search & Data Extraction integration with local subprocess execution. Both servers can be configured concurrently in your client's mcpServers manifest.
Which MCP Server Should You Choose?
Choose Mineru MCP when:
You need dedicated capabilities in the Search & Data Extraction domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: API Key required (BYOK (Pay Provider Direct)).
MCP server for MinerU document parsing API. Parse PDFs, images, DOCX, and PPTX with OCR (109 languages), batch processing (200 docs), page ranges, and local file upload. 73% token reduction with structured output.
Official MinerU document parsing MCP (mineru-open-mcp on PyPI). Converts PDFs, doc/docx/ppt/pptx, images, and spreadsheets to Markdown via the MinerU API; free Flash mode without an API key (about 20 pages per file); optional MINERUAPITOKEN for higher limits.
Category & Scope
Tools & Capabilities Breakdown
Mineru MCP Tools (8)
mineru_parse
Parse a document URL
mineru_status
Check task progress, get download URL
mineru_batch
Parse multiple URLs (max 200)
mineru_batch_status
Get batch results with pagination
mineru_upload_batch
Upload local files for batch parsing
mineru_download_results
Download results as named markdown files
Ready-to-Paste Client Configurations
Paste either (or both) of these JSON server blocks into your client config file (e.g. claude_desktop_config.json or ~/.cursor/mcp.json).
Mineru MCP is categorized under Search & Data Extraction and uses a local stdio subprocess. In contrast, MinerU Ecosystem belongs to Search & Data Extraction using local stdio subprocess. Select Mineru MCP when you need capabilities focused on search & data extraction and MinerU Ecosystem when you require tools for search & data extraction.
Document >200 pages: one batch of ≤200-page `page_ranges` slices
mineru_merge_slices
Stitch a sliced batch into one `{name}.md` + `{name}_content.json` (page_idx re-based) + `images/
MinerU Ecosystem Tools (2)
parse_documents
Convert 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_languages
Return 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.