Log inSubmit server
Mineru MCP logo

Mineru MCP

by linxule

Parse PDFs, office documents, and images through MinerU with OCR, batch jobs, page ranges, and local file uploads.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mineru MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "linxule-mineru-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ],
      "env": {
        "MINERU_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y mineru-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The linxule/mineru-mcp MCP server connects MCP clients to the MinerU document parsing API. It accepts document URLs or local files, supports PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, and JPEG inputs, and can extract text, tables, and formulas. Use it when an agent needs structured document parsing, OCR across 109 languages, selective page extraction, or batch processing of up to 200 files. Processing is asynchronous: submit a task or batch, poll its status, then retrieve or download the results.

Use cases

  • Parse research papers and extract their text, tables, and formulas
  • Process batches of document URLs for downstream analysis
  • Upload local document collections and save parsed Markdown files
  • Extract selected page ranges from large PDFs
  • Run OCR on scanned documents and images

Key features

  • Parse URLs and local files through MinerU
  • Process batches of up to 200 documents
  • Support OCR for 109 languages
  • Extract text, tables, and formulas
  • Select page ranges and export formats
  • Download results as named Markdown files

Tools14

What Mineru MCP lets your agent do. Expand a tool for its parameters.

Self-reported~238 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/20 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · mineru-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads985Package downloads in the last 30 days.
Last commit11d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed14Callable tools this server registers over MCP.
Directory activity14 viewsConfig copies, upvotes, and views on AllMCPs.

How Mineru MCP works

What linxule/mineru-mcp MCP server does

The linxule/mineru-mcp MCP server exposes MinerU’s document parsing API as MCP tools. It is designed for extracting text, tables, and formulas from PDFs, office documents, presentations, and image files. Supported inputs include PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, and JPEG files.

Agents can submit a document URL with mineru_parse, process several URLs with mineru_batch, or upload local files through mineru_upload_batch. Parsing options include the VLM or pipeline model, page ranges, OCR, formula recognition, table recognition, language selection, and additional export formats such as HTML. OCR support covers 109 languages.

How it works

MinerU jobs run asynchronously. A single URL submission returns a task that can be tracked with mineru_status; the status response can include a download URL for the resulting archive. Batch submissions return a batch identifier, which can be checked with mineru_batch_status. Batch status supports pagination through limit and offset values and can return concise or detailed output.

For local files, the typical sequence is upload, poll for completion, and download. mineru_upload_batch can scan a directory or accept an explicit list of files. Once processing finishes, mineru_download_results writes the parsed output as Markdown files. Output names are derived from each file’s data identifier, with spaces converted to underscores, and the tool can optionally overwrite existing files.

The server selects the pipeline model by default. The VLM model is available for complex documents, while the pipeline model is intended for faster processing of simpler documents. OCR can be enabled for pipeline processing, and page ranges can limit extraction to selected pages.

Setup and configuration

The linxule/mineru-mcp MCP server requires Node.js 18 or later and a MinerU API key. Install it as a local stdio server with npx -y mineru-mcp, then provide the key through MINERU_API_KEY.

Configuration variables are:

  • MINERU_API_KEY: required MinerU bearer token.
  • MINERU_BASE_URL: optional API base URL; defaults to https://mineru.net/api/v4.
  • MINERU_DEFAULT_MODEL: optional default model, either pipeline or vlm; defaults to pipeline.

The README provides configuration examples for Claude Desktop, Cursor, Windsurf, Cline, VS Code, and several CLI clients. ChatGPT does not directly support this local stdio setup; it requires a public HTTPS deployment using HTTP transport.

Tools and capabilities

The linxule/mineru-mcp MCP server provides these tools:

  • mineru_parse: submit one document URL for parsing.
  • mineru_status: inspect a task and obtain its result download URL.
  • mineru_batch: submit up to 200 document URLs in one request.
  • mineru_batch_status: retrieve batch results with pagination.
  • mineru_upload_batch: upload local files from a directory or file list.
  • mineru_download_results: save batch results as named Markdown files.

Single files are limited to 200 MB and 600 pages. The service documentation also lists a daily high-priority quota of 2,000 pages. Batch requests can contain at most 200 files.

Limitations and notes

This server depends on the MinerU API and therefore requires a valid MinerU bearer token and network access to the configured API endpoint. It does not parse files independently on the local machine. Results from URL and batch operations must be tracked before they can be downloaded.

Local upload paths and output directories must be supplied by the caller. The README uses placeholders for these paths, so they need to be replaced with paths available to the machine running the MCP client. The project is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mineru MCP

Install Node.js 18 or later, then configure the server with `npx -y mineru-mcp` and provide the required `MINERU_API_KEY` environment variable.

Yes. The README provides a Claude Desktop stdio configuration using `npx -y mineru-mcp` and `MINERU_API_KEY`.

It supports PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, and JPEG files.

Yes. Use `mineru_upload_batch` with either a directory or an explicit list of local file paths, then check the batch and download the results.

A batch request can contain up to 200 documents.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMineru MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/linxule-mineru-mcp?style=directory)](https://allmcps.com/mcp/linxule-mineru-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/linxule-mineru-mcp"><img src="https://allmcps.com/api/badge/linxule-mineru-mcp?style=directory" alt="Mineru MCP on AllMCPs" /></a>