MinerU MCP server

by linxule·io.github.linxule/mineru·v1.2.0·10 stars

No reviews yet

MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.

A92/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A92/100

full report

Adoption

Growing

10 stars130 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

mineru_batch
Parse 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_status
Get batch results. Supports pagination for large batches.
mineru_download_results
Download 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_slices
Stitch 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_parse
Parse a document URL. Returns task_id to check status.
mineru_parse_long
Parse 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_status
Check task progress. Returns download URL when done.
mineru_upload_batchwrite action
Upload 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.10 · 2026-10-03 · same rubric, same numbers if you re-run it

no findings

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 2 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How MinerU compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 92/100; higher than 95% of 48,255 servers
Tools: 8; the typical server has 7
Tools that change things: 13%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 10; more than 88% of 28,688 servers
Downloads a week: 130; more than 68% of 12,191 servers with a package

What its tools let an agent do: 7 read · 1 change

Install MinerU in Claude Code, Cursor or VS Code

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

Add to Cursor

What the publisher says

From the MinerU repository's README, as published. We do not edit it. Read it on GitHub

mineru-mcp

MCP server for MinerU document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images.

Features

VLM model — 90%+ accuracy for complex documents
Pipeline model — Fast processing for simple documents
Local file upload — Upload files from disk for batch parsing
Batch processing — Parse up to 200 documents at once
Download & rename — Extract markdown with original filenames
Page ranges — Extract specific pages only
Long documents — MinerU caps files at 200 pages; mineruparselong slices and minerumergeslices stitches
CLI twin — mineru-cloud runs the same tools from a shell (no MCP context cost)
109 language OCR support
Optimized for Claude Code — 73% token reduction vs alternatives

Tools

Installation

Requires Node.js 18+ and a MinerU API key.

CLI Install (one-liner)

# Claude Code
claude mcp add mineru-mcp -e MINERU_API_KEY=your-api-key -- npx -y mineru-mcp

# Codex CLI (OpenAI)
codex mcp add mineru --env MINERU_API_KEY=your-api-key -- npx -y mineru-mcp

# Gemini CLI (Google)
gemini mcp add -e MINERU_API_KEY=your-api-key mineru npx -y mineru-mcp

Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json (workspace) or open Command Palette > MCP: Open User Configuration (global):

{
  "servers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Note: VS Code uses "servers" as the top-level key, not "mcpServers". Other VS Code forks (Trae, Void, PearAI, etc.) typically use this same format.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcpconfig.json (Windows: %USERPROFILE%\.codeium\windsurf\mcpconfig.json):

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Cline

Open MCP Servers icon in Cline panel > Configure > Advanced MCP Settings, then add:

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Cherry Studio

In Settings > MCP Servers > Add Server, set Type to STDIO, Command to npx, Args to -y mineru-mcp, and add environment variable MINERUAPIKEY. Or paste in JSON/Code mode:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

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, Cursor, VS Code or Claude Desktop 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 34 days ago (2026-10-01). The latest release is v1.2.0.
What can I use instead of MinerU?: Servers from other publishers that do the same job: kordoc MCP server and Docling MCP server.
How does MinerU compare with other MCP servers?: safety score 92/100 (higher than 95% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to MinerU

Same job from other publishers: the closest match first, then the best rated.

kordoc
Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX, PPTX) to Markdown; fill forms, diff, render.
not reviewed
Widely used
A
Docling MCP
Convert PDFs and other documents to structured formats via Docling, for AI applications.
not reviewed
Established
A