How do I install the mineru mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MINERU_API_KEY`, `MINERU_BASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MinerU MCP Server

MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.

Local serverstdioTypeScript

What is the MinerU MCP Server?

MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.

What the server does

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

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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

How to install the MinerU MCP Server

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-value",
        "MINERU_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
MINERU_API_KEY	Credential the server authenticates with.	Yes
MINERU_BASE_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use MinerU to mineru parse.”
“Use MinerU to mineru status.”
“Use MinerU to mineru batch.”

Frequently asked questions

MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the MinerU MCP Server

EverArt Forge

Generates both vector and raster images using EverArt's AI models, providing flexible storage and format conversion.

AI & ML Services★ 10

Filesystem

Provides file system operations, analysis, and manipulation through a standardized tool interface.

File Systems & StorageTypeScript★ 6

1aivault-mcp-server

1AIVault is a local-first desktop app that acts as a portable memory vault for AI tools. It stores your memories, decisions, preferences, and reusable skills in a local SQLite database and exposes…

Databases

302 File Parser MCP

A Model Context Protocol server

Data Processing & Conversion

5dive-mcp

Expose the 5dive agent-fleet CLI as Model Context Protocol tools. Point any MCP client (Claude Desktop, Cursor, Cline, or your own) at this stdio server to file tasks, inspect and message agents, and read the fleet…