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

Links

• MinerU - Document parsing service
• MinerU GitHub - Open source version
• MCP Specification - Model Context Protocol