Advertise
MCP.so
Sign In

Mineru MCP Server

@linxule

Repository

Basic information

Category

Other

Transports

stdio

Author

linxule

Submitted by

Xule Lin

About Mineru MCP Server

No overview available yet

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

Mineru MCP Server 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"
      }
    }
  }
}

Mineru MCP Server 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

Frequently asked questions

1

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.

2

What is the daily usage quota?

The daily quota is 2000 pages at high priority.

3

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.

4

Does Mineru require an API key?

Yes, a MinerU API key is required. Get one at [mineru.net](https://mineru.net). Set it as the `MINERU_API_KEY` environment variable.

5

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

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise