Mineru
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
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MineruCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



