MinerU
Parse PDFs, images, DOCX and PPTX to Markdown with the MinerU cloud API, with OCR
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 2.0.0
- Listing updated
- today
Similar MCP servers
About MinerU
MinerU is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
This server and its companion mineru-cloud CLI wrap the MinerU document-parsing API, and the README stresses keeping everything: complete result archives, durable local operation journals and portable PDF bundles. It needs a MinerU API key and Node.js 20 or newer (the README recommends 24), and version 1.x stays available for Node 18.
Parsing can use a vision-language model or the pipeline model, with language and OCR options for the latter, page ranges, batches of URLs, and uploads of local files. For long documents, mineru_parse_long submits page-range slices and mineru_merge_slices stitches the Markdown back together while retaining the slice archives. Submissions can be journaled with duplicate-request protection and resumed after interruptions; remote cancellation is not supported.
An offline command builds a portable Scholia bundle from a provider ZIP and the source PDF, with no credentials. Local retention and bundles need macOS or Linux and fail closed on Windows. ChatGPT cannot use it directly because it is a local stdio server.
Install
Run in a terminal
claude mcp add mineru -- npx -y mineru-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mineru": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- mineru_parse
- Parse a document URL
- mineru_status
- Check task progress and 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 archives and create named copies
- mineru_parse_long
- Submit a long document as page-range slices
- mineru_merge_slices
- Join Markdown from slices
- mineru_capabilities
- Read known capabilities
- mineru_submit
- Submit with a durable local journal
- mineru_operation_status
- Read a recorded operation
- mineru_resume
- Continue recorded checkpoints
- mineru_cancel
- Stop local processing
- mineru_bundle
- Validate and return a retained bundle
What it does
- Two parsing models
- Vision-language or pipeline model, with language and OCR options.
- Batch and upload
- Parse many URLs or upload local files in one request.
- Long documents
- Slice by page range, then merge the Markdown.
- Durable operations
- Journal, resume and check submissions with duplicate protection.
- Portable bundles
- Validate and return retained archives, offline if needed.
- CLI twin
- mineru-cloud exposes every tool as a shell command.
Good for
- Convert a research PDF to Markdown
- Batch-parse a folder of scanned documents
- Process a 500-page book in slices
- Archive parsing output with original filenames
Pricing
Open source
Server is open source; the MinerU API needs an API key, pricing not published
MinerU FAQ
What do I need to run it?
A MinerU API key and Node.js 20 or newer, started with npx -y mineru-mcp.
Can I use it in ChatGPT?
Not directly. ChatGPT supports only remote HTTPS MCP servers and this one is local stdio.
Does it work on Windows?
The server runs there with a cmd wrapper, but local retention, bundles and durable operations require macOS or Linux.
Can I cancel a remote parse?
No. mineru_cancel stops local processing only; remote cancellation is unsupported.
Is MinerU free?
Yes. MinerU is open source, so you can use and self-host it for free.
How do I add MinerU to Claude Code?
Run this command in your terminal: claude mcp add mineru -- npx -y mineru-mcp
What are the best alternatives to MinerU?
The closest alternatives to MinerU are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
