Mineru

by linxule

8 stars
633 downloads
Not rated
GitHub

Description

# mineru-mcp MCP server for [MinerU](https://mineru.net) document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images. ## Features - **VLM model** — 90%+ accuracy for complex documents - **Pipeline model** — Fast processing for simple documents - **Local…

About

# mineru-mcp MCP server for [MinerU](https://mineru.net) document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images. ## Features - **VLM model** — 90%+ accuracy for complex documents - **Pipeline model** — Fast processing for simple documents - **Local file upload** — Upload files from disk…

Details

Author
linxule
GitHub stars
8
Downloads
633
Categories
Other

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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mineru
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

mineru-mcp

MCP server for MinerU document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images.

Features

- VLM model — 90%+ accuracy for complex documents
- Pipeline model — Fast processing for simple documents
- Local file upload — Upload files from disk for batch parsing
- Batch processing — Parse up to 200 documents at once
- Download & rename — Extract markdown with original filenames
- Page ranges — Extract specific pages only
- 109 language OCR support
- Optimized for Claude Code — 73% token reduction vs alternatives

Tools

| Tool | Description |
|------|-------------|
| mineru_parse | Parse a document URL |
| mineru_status | Check task progress, get download URL |
| mineru_batch | Parse multiple URLs (max 200) |
| mineru_batch_status | Get batch results with pagination |
| mineru_upload_batch | Upload local files for batch parsing |
| mineru_download_results | Download results as named markdown files |

Installation

Requires Node.js 18+ and a MinerU API key.

CLI Install (one-liner)

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.