Skip to content
MCP server

MinerU

Parse PDFs, images, DOCX and PPTX to Markdown with the MinerU cloud API, with OCR

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers