Skip to main content
Glama

mineru-mcp

MCP server for MinerU document parsing API - optimized for Claude Code.

Features

  • 4 optimized tools with concise descriptions (~73% token reduction vs alternatives)

  • VLM model support (90%+ accuracy) and pipeline mode (faster)

  • Page range selection - parse specific pages only

  • Batch processing - up to 200 documents at once

  • Pagination - efficient handling of large batch results

  • 109 language OCR support

Installation

Claude Code

claude mcp add mineru-mcp -e MINERU_API_KEY=your-api-key -- npx mineru-mcp

Claude Desktop

Add to your Claude Desktop config:

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

Configuration

Environment Variable

Default

Description

MINERU_API_KEY

(required)

Your MinerU API Bearer token

MINERU_BASE_URL

https://mineru.net/api/v4

API base URL

MINERU_DEFAULT_MODEL

pipeline

Default model: pipeline or vlm

Get your API key at mineru.net

Tools

mineru_parse

Parse a single document URL.

mineru_parse({ url: "https://example.com/document.pdf", model: "vlm", // optional: "pipeline" (default) or "vlm" (90% accuracy) pages: "1-10,15", // optional: page ranges ocr: true, // optional: enable OCR (pipeline only) formula: true, // optional: formula recognition table: true, // optional: table recognition language: "en", // optional: language code formats: ["html"] // optional: extra export formats })

mineru_status

Check task progress and get download URL.

mineru_status({ task_id: "abc-123", format: "concise" // optional: "concise" (default) or "detailed" })

Concise output: done | abc-123 | https://cdn-mineru.../result.zip

mineru_batch

Parse multiple documents in one batch (max 200).

mineru_batch({ urls: ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"], model: "vlm" })

mineru_batch_status

Get batch results with pagination.

mineru_batch_status({ batch_id: "batch-123", limit: 10, // optional: max results (default: 10) offset: 0, // optional: skip first N results format: "concise" // optional: "concise" or "detailed" })

Supported Formats

  • PDF, DOC, DOCX, PPT, PPTX

  • PNG, JPG, JPEG

Limits

  • Single file: 200MB max, 600 pages max

  • Daily quota: 2000 pages at high priority

  • Batch: max 200 URLs per request

License

MIT

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/linxule/mineru-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server