Mineru

@linxule

About Mineru

No overview available yet

#pdf #ocr #document-parsing #data-extraction #batch-processing

Basic information

Category

Other

Runtime

node

Transports

stdio

Publisher

linxule

Submitted by

Xule Lin

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

6

Parse a document URL

Check task progress, get download URL

Parse multiple URLs (max 200)

Get batch results with pagination

Upload local files for batch parsing

Download results as named markdown files

Overview

What is Mineru?

Mineru is an MCP (Model Context Protocol) server for the MinerU document parsing API. It extracts text, tables, and formulas from PDFs, DOCs, and images, and is designed for use with AI coding assistants like Claude Code, Codex CLI, and Gemini CLI.

How to use Mineru?

Install via npx -y mineru-mcp (requires Node.js 18+ and a MinerU API key). Configure the server in your MCP client (e.g., Claude Desktop, VS Code, Cursor, Windsurf) by setting the command to npx, args to -y mineru-mcp, and adding the environment variable MINERU_API_KEY. Then use the provided tools: mineru_parse, mineru_status, mineru_batch, mineru_batch_status, mineru_upload_batch, and mineru_download_results.

Key features of Mineru

VLM model: 90%+ accuracy for complex documents
Pipeline model: fast processing for simple documents
Local file upload for batch parsing
Batch processing of up to 200 documents at once
Download and rename extracted markdown with original filenames
Page-range extraction and 109-language OCR support
Optimized for Claude Code (73% token reduction vs alternatives)

Use cases of Mineru

Extract text and tables from academic PDFs
Parse multi-page documents with formulas and images
Batch process a folder of documents for market research
Convert scanned images (PNG/JPG) to markdown via OCR
Integrate document parsing into AI coding assistant workflows

FAQ from Mineru

What file size and page limits does Mineru have?

Single file: 200 MB max and 600 pages max. Batch: up to 200 files per request.

What is the daily usage quota?

The daily quota is 2000 pages at high priority.

What models are available and when should I use each?

Mineru offers two models: pipeline (default) for fast processing of simple documents, and vlm for complex documents requiring 90%+ accuracy.

Does Mineru require an API key?

Yes, a MinerU API key is required. Get one at mineru.net. Set it as the MINERU_API_KEY environment variable.

Does Mineru support remote MCP (e.g., ChatGPT)?

No, Mineru uses local stdio transport. ChatGPT only supports remote MCP servers over HTTPS, so it is not directly compatible.

Comments

More Other MCP servers

Awesome-MCP-ZH

MCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

Servers

modelcontextprotocol

Model Context Protocol Servers

Awesome Mcp Servers

A collection of MCP servers.

Inbox Zero AI

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.