A side-by-side look at the Mineru MCP and MinerU Open MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Mineru MCP for search & data extraction work as a local process; choose MinerU Open MCP for search & data extraction as a local process. You can also run both side by side in one mcpServers block.
MINERU_API_KEY.mineru_parse, mineru_status, mineru_batch.parse_documents, get_ocr_languages.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Search & Data Extraction | Search & Data Extraction |
| Quality signal | 60/100 · Good | 61/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | API key required | Not declared |
| Pricing | BYOK (pay the provider) | Not declared |
| Required env vars | MINERU_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 10 | 222 |
| Directory activity | 5 views 0 installs 0 upvotes | 2 views 0 installs 0 upvotes |
| Tools | 14 | 2 |
| Full listing | View Mineru MCP | View MinerU Open MCP |
mineru_parseParse a document URLmineru_statusCheck task progress, get download URLmineru_batchParse multiple URLsmineru_batch_statusGet batch results with paginationmineru_upload_batchUpload local files for batch parsingmineru_download_resultsRetain complete archives, inventory all members, and create named compatibility copiesmineru_parse_longSubmit a long document as a batch of page-range slicesmineru_merge_slicesJoin available Markdown and retain immutable slice archives with explicit unknown page provenancemineru_capabilitiesRead locally known capabilities; explicit refresh performs discoverymineru_submitSubmit with a durable local journal and duplicate-request protectionmineru_operation_statusRead a recorded operation; explicit refresh checks remote statusmineru_resumeContinue safe recorded checkpointsparse_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.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": {
"linxule-mineru-mcp": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
],
"env": {
"MINERU_API_KEY": "YOUR_MINERU_API_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"mineru-open-mcp": {
"command": "uvx",
"args": [
"mineru-open-mcp"
]
}
}
}