MinerU — Claude Code MCP server: parsing and setup
This MCP server sends PDFs, images, DOCX, and PPTX to MinerU for parsing, OCR, and batch jobs. Use it when an agent needs structured document output.
claude mcp add mineru -- npx -y mineru-mcpWhat MinerU does
MinerU exposes MinerU document-processing tools to an agent. It can parse a document URL, upload files from disk, handle several documents in one request, limit extraction to selected pages, and report task status. Results can be retrieved as Markdown with the original file names.
Long files can be split into page-range jobs and assembled from the available Markdown parts. The server also provides recorded operations, checkpoint continuation, cancellation of local processing, and bundle validation. Cloud actions need MINERU_API_KEY; offline bundle creation can run without credentials.
Local result retention, bundles, and recorded operations require macOS or Linux. On Windows, those filesystem paths fail closed. New setups should use Node.js 24; Node.js 18 or newer is supported as well.
What it helps with
- parse a PDF, DOCX, or PPTX from a URL
- send local files for batch processing
- extract Markdown from selected pages
- check a task and fetch its result
- split a long document and join its Markdown parts
Example prompts for the agent
- Parse this PDF and return the extracted content as Markdown.
- Upload these local documents as one batch and keep their original file names in the results.
- Process this long document by page ranges, then combine the available Markdown slices.
How to install MinerU
Platform CLI
claude mcp add mineru -- npx -y mineru-mcpPlatform CLI
codex mcp add mineru -- npx -y mineru-mcpConfig file
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Config file
{
"servers": {
"mineru": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Platform CLI
gemini mcp add mineru npx -y mineru-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MinerU
How do I install MinerU in Claude Code?
Run claude mcp add mineru -- npx -y mineru-mcp. Set MINERU_API_KEY for cloud operations.
What does MinerU do?
It gives an agent tools for document parsing, OCR, batch requests, page selection, status checks, and Markdown output. Long documents can be handled as page-range jobs.
What does MinerU require?
Cloud commands require a MinerU API key. New installations should use Node.js 24, while Node.js 18 or later is supported; local retention and recorded operations require macOS or Linux.
