MinerU MCP server
MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.
10 stars656 downloads/wk
Reviews
Write oneNobody has reviewed MinerU yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MinerU tools (8, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
mineru_batchParse multiple URLs in one batch (max 200). Preferred over mineru_upload_batch — faster and more reliable. Use public URLs (arXiv, SSRN, publisher sites) when available.
mineru_batch_statusGet batch results. Supports pagination for large batches.
mineru_download_resultsDownload batch results and extract named paper folders. Each folder contains {name}.md, {name}_content.json (structured TOC), and images/. Output includes parsed title — verify it matches the expected paper.
mineru_merge_slicesStitch the slices of a mineru_parse_long batch into one {name}/{name}.md (+ {name}_content.json with page_idx re-based to the whole document, + images/). Slices are ordered by their page range; each is marked with an HTML comment. Waits for nothing — if any slice is still processing, it reports and you re-run later.
mineru_parseParse a document URL. Returns task_id to check status.
mineru_parse_longParse a document LONGER than 200 pages (MinerU's per-file cap) by submitting it as one batch of ≤200-page slices with page_ranges. Give total_pages (from `mdls -name kMDItemNumberOfPages`, `pdfinfo`, or the viewer) — it is auto-detected only for local files on macOS. Returns a batch_id; poll with mineru_batch_status, then stitch with mineru_merge_slices. Files ≤200 pages: use mineru_parse instead.
mineru_statusCheck task progress. Returns download URL when done.
mineru_upload_batchwrite actionUpload local files for batch parsing. SLOW: uploads can take minutes and may timeout. Prefer mineru_batch with public URLs (arXiv, SSRN, publisher sites) when available — it's faster and more reliable. Only use this for files not available online.
Public scan report
scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install directly
Runs npx -y mineru-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mineru -- npx -y mineru-mcp
MinerU: common questions
- Is MinerU MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the MinerU safety report
- How do I install MinerU?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does MinerU need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is MinerU maintained?
- The last commit was 3 days ago (2026-09-16). The latest release is v1.2.0.