MCP 服务器

MinerU MCP Server

Enables document parsing and extraction from PDFs and other formats using the MinerU API. Supports batch processing, page range selection, OCR in 109 languages, and VLM/pipeline models for high-accuracy content extraction.

README

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"
})