mineru-mcp
MCP server and mineru-cloud CLI for the MinerU document
parsing API, with complete artifact retention, durable operations, and portable
PDF bundles.
Durable operations and bundles in this checkout are unreleased. The published
mineru-mcp@1.2.0 does not include them; npm users need a release containing these
changes.
Features
- VLM model — Document parsing with a vision-language model
- Pipeline model — Document parsing with the pipeline model
- Local file upload — Upload files from disk for batch parsing
- Batch processing — Submit multiple documents in one request
- Download & rename — Extract markdown with original filenames
- Page ranges — Extract specific pages only
- Long documents —
mineru_parse_longsubmits page-range slices andmineru_merge_slicesstitches - CLI twin —
mineru-cloudcalls the same tools from a shell - Language and OCR options — Select a language and enable OCR for the pipeline model
Tools
| Tool | Description |
|---|---|
mineru_parse |
Parse a document URL |
mineru_status |
Check task progress, get download URL |
mineru_batch |
Parse multiple URLs |
mineru_batch_status |
Get batch results with pagination |
mineru_upload_batch |
Upload local files for batch parsing |
mineru_download_results |
Retain complete archives, inventory all members, and create named compatibility copies |
mineru_parse_long |
Submit a long document as a batch of page-range slices |
mineru_merge_slices |
Join available Markdown and retain immutable slice archives with explicit unknown page provenance |
mineru_capabilities |
Read locally known capabilities; explicit refresh performs discovery |
mineru_submit |
Submit with a durable local journal and duplicate-request protection |
mineru_operation_status |
Read a recorded operation; explicit refresh checks remote status |
mineru_resume |
Continue safe recorded checkpoints |
mineru_cancel |
Stop local processing; remote cancellation is unsupported |
mineru_bundle |
Validate and return an operation's retained bundle |






