MCP-MinerU
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-MinerU extract all tables from quarterly_report.pdf using the fastest backend"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-MinerU
MCP server for document and image parsing via MinerU. Extract text, tables, and formulas from PDFs, screenshots, and scanned documents with MLX acceleration on Apple Silicon.
Installation
claude mcp add --transport stdio --scope user mineru -- \
uvx --from mcp-mineru python -m mcp_mineru.serverThis command installs and configures the server for all your Claude Code projects using uvx (no manual installation required).
Alternative methods: See Installation Guide for PyPI, source installation, and Claude Desktop configuration.
Related MCP server: PDF MCP Flow
Features
Multiple format support: PDF, JPEG, PNG, and other image formats
OCR capabilities: Built-in text extraction from screenshots and photos
Table recognition: Preserves structure when extracting tables
Formula extraction: Converts mathematical equations to LaTeX
MLX acceleration: Optimized for Apple Silicon (M1/M2/M3/M4)
Multiple backends: Choose speed vs quality tradeoffs
Quick Start
Parse a PDF document
User: "Analyze the tables in research_paper.pdf"
Claude: [Calls parse_pdf tool] "The paper contains 3 tables..."Extract text from a screenshot
User: "What does this screenshot say? image.png"
Claude: [Calls parse_pdf tool] "The screenshot contains..."Check system capabilities
User: "Which backend should I use?"
Claude: [Calls list_backends tool] "Your system has Apple Silicon M4..."For more examples, see Usage Examples.
Tools
parse_pdf
Parse PDF and image files to extract structured content as Markdown.
Parameters:
file_path(required): Absolute path to file (PDF, JPEG, PNG, etc.)backend(optional):pipeline|vlm-mlx-engine|vlm-transformersformula_enable(optional): Enable formula recognition (default: true)table_enable(optional): Enable table recognition (default: true)start_page(optional): Starting page for PDFs (default: 0)end_page(optional): Ending page for PDFs (default: -1)
list_backends
Check system capabilities and get backend recommendations.
Returns: System information, available backends, and performance recommendations.
Supported Formats
PDF documents (.pdf)
JPEG images (.jpg, .jpeg)
PNG images (.png)
Other image formats (WebP, GIF, etc.)
Performance
Benchmarked on Apple Silicon M4 (16GB RAM):
pipeline: ~32s/page, CPU-only, good quality
vlm-mlx-engine: ~38s/page, Apple Silicon optimized, excellent quality
vlm-transformers: ~148s/page, highest quality, slowest
Documentation
Installation Guide - Detailed installation options
Updating Guide - How to update to the latest version
Usage Examples - More use cases and API reference
MinerU Documentation - Underlying parsing engine
Development
git clone https://github.com/TINKPA/mcp-mineru.git
cd mcp-mineru
uv pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src/
ruff check src/License
Apache License 2.0 - see LICENSE file for details.
Acknowledgments
Built on top of MinerU by OpenDataLab.
Available Tools
2 toolslist_backendsB
Check system capabilities and list recommended backends for document and image parsing
Inputs: no named parameters.
parse_pdfA
Parse PDF and image files (PDF, JPEG, PNG, etc.) to extract text, tables, formulas, and structure using MinerU vunknown. Supports multiple backends including MLX-accelerated inference on Apple Silicon. Works with documents, screenshots, photos, and scanned images.
Inputs: file_path (required), backend, end_page, start_page, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
parse_pdf and list_backends have completely distinct purposes: one performs the actual document/image parsing, while the other reports system capabilities. No overlap or ambiguity exists between them.
Both tool names follow a consistent verb_noun pattern in snake_case (parse_pdf, list_backends). The naming is predictable and uniform across the set.
With only two tools, the server feels minimal for its stated purpose of document and image parsing. While the scope is narrow, a slightly more complete set (e.g., separate format detection or result retrieval) might be expected in a fuller-featured server.
For the domain of document parsing, parse_pdf covers the core extraction of text, tables, formulas, and structure across multiple file types, while list_backends addresses capability discovery. There are no obvious dead ends or missing critical operations within this focused scope.
Maintenance
Related MCP Connectors
Convert PDF, Word, Excel and scanned documents to Markdown, tables and RAG chunks. OCR.
Convert PDF pages into editable Word-ready text from your AI chat, all offline.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Agent-native document parsing: PDF, scans and FR/EU invoices to structured JSON or Markdown.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides offline, high-accuracy OCR capabilities for images and PDFs using macOS's built-in Vision framework. Supports multi-language text extraction with intelligent block aggregation for tables and paragraphs, outputting structured JSON data suitable for document reconstruction.1-
- AlicenseNot gradedqualityCmaintenanceEnables AI-driven PDF document processing including PDF to Markdown conversion, intelligent text and table extraction, image extraction, format conversion between PDF/Word/Markdown, batch processing, and fuzzy search - optimized for LLM context and RAG workflows.2MIT
- AlicenseNot gradedqualityCmaintenanceProvides AI agents with comprehensive document parsing capabilities including PDF text extraction, OCR, HTML-to-markdown conversion, table extraction, and summarization, optimized for agent workflows.75 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables intelligent document processing by extracting text, classifying document types, and generating structured summaries from PDFs and images using vision LLMs.MIT