Log inSubmit server
MinerU Ecosystem logo

MinerU Ecosystem

by opendatalab

Converts PDFs, office files, images, and spreadsheets into Markdown through MinerU, with optional OCR and page-range controls.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MinerU Ecosystem

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "opendatalab-mineru-ecosystem": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "YOUR_VALUE_HERE",
        "OUTPUT_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 2 tools correctly (4d ago).

Overview

opendatalab/MinerU-Ecosystem exposes MinerU document parsing through MCP tools for local files and remote URLs. Its main parser converts PDFs, Word documents, PowerPoint files, images, and supported spreadsheets into Markdown, preserving tables and formulas where available. Flash mode runs without an API token with lower limits, while MINERU_API_TOKEN enables higher limits and additional output options. Use it when an MCP client needs structured text extraction from uploaded documents or web-hosted files.

Use cases

  • Extract text and tables from research PDFs
  • Convert Word and PowerPoint files into Markdown
  • Parse selected page ranges from multiple documents
  • Process remote document URLs for downstream analysis
  • Run OCR on supported image and document inputs

Key features

  • PDF, office document, image, and spreadsheet parsing
  • Local file and remote URL inputs
  • Markdown output with tables and formulas
  • Page-range selection for individual files
  • OCR language discovery and selection
  • stdio and streamable HTTP transports

Tools2

What MinerU Ecosystem lets your agent do. Expand a tool for its parameters.

Verified live~819 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/20 checks healthy over the last 78d

What it can do

From the 2 tools this server returned when we ran it; 2 declare their own safety hints.

Makes network requests · 1Read-only tools · 2
Network at startup2 connections
Files written at startup10

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mineru-open-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars230Stargazers on the source repository.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed2Callable tools this server registers over MCP.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How MinerU Ecosystem works

What opendatalab/MinerU-Ecosystem MCP server does

opendatalab/MinerU-Ecosystem connects MCP-compatible clients to the official MinerU API at mineru.net. It accepts local file paths and remote URLs, sends the selected documents for parsing, and makes the resulting content available to the client as Markdown or saved output files.

Supported inputs include PDF, DOC, DOCX, PPT, PPTX, and common image formats such as PNG, JPG, JPEG, JP2, WEBP, GIF, and BMP. Flash mode also accepts XLS and XLSX files. Parsed content can retain tables as HTML and formulas as LaTeX. Page ranges can be assigned to individual files, which is useful when processing only selected sections of a document.

How it works

The server can run over stdio, where the MCP client starts it as a subprocess, or through streamable HTTP for clients that connect to a running endpoint. A typical stdio setup launches the mineru-open-mcp PyPI package with uvx. For HTTP use, start the process with the streamable HTTP transport and connect to its /mcp endpoint.

Single-document results are returned inline when practical. Batch jobs, or responses that are too large for inline delivery, are written to the configured output directory and returned with file metadata, an extraction path, or a download URL. Prompts can also specify a page range, parsing model, OCR language, or output directory.

Files supplied through a client may reside in a sandboxed temporary directory. When parsing local files, provide their full paths so the server can locate them.

Setup and configuration

Install uv and launch the published mineru-open-mcp package with uvx, or install and run the package directly. The server works without credentials in Flash mode. Set MINERU_API_TOKEN to use the full MinerU service and its higher limits. Flash mode is restricted to Markdown output and has lower limits, including an approximately 20-page-per-file limit described for the free path.

OUTPUT_DIR controls where batch results and oversized inline responses are saved; its default is ~/mineru-downloads. An HTTP deployment can be started with a command such as mineru-open-mcp --transport streamable-http --port 8001, then registered at http://127.0.0.1:8001/mcp.

Documents and URLs submitted for parsing are sent to MinerU. Parsed results are temporarily cached by the service and are not used for training. Local output files are stored in the selected output directory.

Tools and capabilities

  • parse_documents parses local files and remote URLs, with per-file page ranges and configurable output handling.
  • get_ocr_languages lists OCR languages supported by MinerU.
  • Flash mode supports PDF, images, DOCX, PPTX, XLS, and XLSX inputs without an API token.
  • Authenticated operation supports the broader documented file set and additional output formats.
  • Parsing requests can select the pipeline or VLM model, choose an OCR language, and set a custom output directory.

The server is suited to document search, extraction, summarization, and downstream analysis performed by an MCP client after conversion to Markdown.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MinerU Ecosystem

opendatalab/MinerU-Ecosystem is an MCP server that connects MCP clients to the official MinerU API for document parsing. Its main tools, `parse_documents` and `get_ocr_languages`, convert local files or remote URLs into Markdown and list supported OCR languages, with optional page ranges, model selection, and output paths.

Install `uv`, then configure your MCP client to launch the PyPI package with `uvx mineru-open-mcp`. The client starts the server over stdio. You can also run the command directly or start it with streamable HTTP for a web-based MCP connection.

Yes, Cursor is named as a supported stdio client. Configure Cursor to launch `uvx` with the `mineru-open-mcp` argument, and optionally provide `MINERU_API_TOKEN` in the server environment.

Yes, Flash mode runs without an API key and provides free Markdown parsing with lower limits. Setting `MINERU_API_TOKEN` enables higher limits and additional output formats.

Provide the file's full path in the MCP prompt and ask the server to parse it. Full paths help when the MCP client places dragged-in files in a sandboxed temporary directory. You can also specify page ranges, OCR language, model, or an output directory.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMinerU Ecosystem AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/opendatalab-mineru-ecosystem?style=directory)](https://allmcps.com/mcp/opendatalab-mineru-ecosystem)
HTML Embed
<a href="https://allmcps.com/mcp/opendatalab-mineru-ecosystem"><img src="https://allmcps.com/api/badge/opendatalab-mineru-ecosystem?style=directory" alt="MinerU Ecosystem on AllMCPs" /></a>