mcpbeat Sign in

MinerU MCP Server

local only

MinerU runs on your own machine — the client starts it, so there is no endpoint to ping. 206 installs a week from npm. Last commit 5 Oct 2026.

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

Installs per day peak 370 · avg 42 · -9% w/w
a month agotoday
206
Installs / week
npm · mineru-mcp
10
Stars
0 open issues
5 Oct 2026
Last commit
3 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 4 d ago · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a dangerous call mineru_parse.url → src/index.ts:768, mineru_batch_status.batch_id → src/index.ts:863, mineru_batch_status.batch_id → src/index.ts:927 и ещё 3
          const out = execFileSync("mdls", ["-raw", "-name", "kMDItemNumberOfPages", params.file], { timeout: 10_000 }).toString().trim();
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/bundle/filesystem.ts:48
  const result = spawnSync(process.execPath, [...workerLoaders,workerPath, JSON.stringify(command)], {
Reads files and sends them to the network src/index.ts:13
import { readFileSync, createWriteStream, readdirSync, statSync, mkdirSync, existsSync, unlinkSync, rmSync, realpathSync, copyFileSync } from "node:fs";

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mineru -- npx -y mineru-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.mineru]
command = "npx"
args = ["-y", "mineru-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mineru": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ]
    }
  }
}

Alternatives to MinerU

same job, measured the same way
MinerU Open MCP
by opendatalab

Parse PDFs, images, doc, docx, ppt, pptx, xls, xlsx, html into Markdown using MinerU API.

470 installs/wk local only
Suparse Document Processing
by suparse

Extract data, create schemas, and export results from PDFs and documents with Suparse AI OCR.

179 installs/wk local only
Transloadit Media Processing
by transloadit

Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.

2 830 installs/wk 7 tools answering
MinerU MCP
by germaniu

Parse PDF, DOCX, PPTX, XLSX and images to Markdown (tables, LaTeX) via a self-hosted MinerU API.

local only
Skavio PDF, OCR & Document Processing MCP
by skavio-eu

Company OAuth PDF, OCR, invoice and audio processing with measured jobs and prepaid company credits.

answering
APICK OCR
by apick

OCR for images and Korean ID documents

6 tools answering
Razi Document Tools
by razikallayi

Document processing over MCP: merge, split and compress PDFs, run OCR, extract document text.

6 tools answering
Document Processing
by filegraph

Extract text from documents, manipulate PDFs, and perform OCR on images.

9 tools answering

MinerU — questions

Answers built from our own checks of this server.

Why is there no uptime for MinerU?
MinerU runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package mineru-mcp was installed 206 times last week.
How do I connect MinerU?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls mineru-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use MinerU?
The npm package mineru-mcp was installed 206 times in the last week. Week over week that is -9%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is MinerU open source?
Yes — it is published under the MIT licence, written in TypeScript and 10 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.