Mineru
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…
Explore
- 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
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
Requires Node.js 18+ and a MinerU API key.
Alternatively, edit ~/.codex/config.toml directly:
[mcp_servers.mineru]
command = "npx"
args = ["-y", "mineru-mcp"]
[mcp_servers.mineru.env]
MINERU_API_KEY = "your-api-key"
Alternatively, edit ~/.gemini/settings.json directly:
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": ["-y", "mineru-mcp"],
"env": {
"MINERU_API_KEY": "your-api-key"
}
}
}
}
```
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
| 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 |
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"
}
}
}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.
