What is the key difference between MinerU Ecosystem and Mineru MCP?

MinerU Ecosystem belongs to the Search & Data Extraction category with local stdio execution, while Mineru MCP belongs to the Search & Data Extraction category with local stdio execution.

How do I install MinerU Ecosystem or Mineru MCP in Claude Desktop or Cursor?

Copy the mcpServers JSON configuration snippet provided on this page into your claude_desktop_config.json or ~/.cursor/mcp.json file and restart your AI client.

Are MinerU Ecosystem and Mineru MCP free or paid?

MinerU Ecosystem operates under a Free / Open Source model (API Key required). Mineru MCP operates under a BYOK (Pay Provider Direct) model (API Key required).

Which MCP server has more tools and community activity?

MinerU Ecosystem lists 2 tools with 3 views and 215 GitHub stars. Mineru MCP lists 8 tools with 5 views and 10 GitHub stars.

Can I use both MinerU Ecosystem and Mineru MCP together in the same MCP host?

Yes! MCP hosts like Claude Desktop, Cursor, Windsurf, Cline, and VS Code support configuring multiple servers under the mcpServers object simultaneously.

Side-by-Side Model Context Protocol Comparison

MinerU Ecosystem vs Mineru MCP

In-depth architectural comparison of the MinerU Ecosystem and Mineru MCP MCP servers. Compare execution transports, security boundaries, tool capabilities, quality scores, and ready-to-paste client installation snippets for Claude, Cursor, Windsurf, and VS Code.

At a Glance & Executive Verdict

MinerU Ecosystem

Search & Data Extraction · Local stdio

Quality: 64/100 (Good) | Auth: API Key required

Mineru MCP

Search & Data Extraction · Local stdio

Quality: 60/100 (Good) | Auth: API Key required

Verdict Summary: Choose MinerU Ecosystem if you need specialized Search & Data Extraction tools running via a local process. Choose Mineru MCP if your workspace requires Search & Data Extraction integration with local subprocess execution. Both servers can be configured concurrently in your client's mcpServers manifest.

Which MCP Server Should You Choose?

Choose MinerU Ecosystem when:

You need dedicated capabilities in the Search & Data Extraction domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: API Key required (Free / Open Source).
You have access to required keys: MINERUAPITOKEN.
Primary tools included: parse_documents, get_ocr_languages.

Explore MinerU Ecosystem Details

Choose Mineru MCP when:

You need dedicated capabilities in the Search & Data Extraction domain.
You prefer local stdio subprocess transport architecture.
Your security boundary fits: API Key required (BYOK (Pay Provider Direct)).
You have access to required keys: MINERU_API_KEY.
Primary tools included: mineru_parse, mineru_status, mineru_batch.

Feature & Specification Comparison

Specification	MinerU Ecosystem opendatalab Search & Data Extraction	Mineru MCP linxule Search & Data Extraction
Summary	Official MinerU document parsing MCP (mineru-open-mcp on PyPI). Converts PDFs, doc/docx/ppt/pptx, images, and spreadsheets to Markdown via the MinerU API; free Flash mode without an API key (about 20 pages per file); optional MINERUAPITOKEN for higher limits.	MCP server for MinerU document parsing API. Parse PDFs, images, DOCX, and PPTX with OCR (109 languages), batch processing (200 docs), page ranges, and local file upload. 73% token reduction with structured output.
Category & Scope

Tools & Capabilities Breakdown

MinerU Ecosystem Tools (2)

parse_documents

Convert PDFs, Word (DOCX), PowerPoint (PPTX), Excel (XLSX in Flash mode), images, and public document URLs—or HTML page URLs—into Markdown using the MinerU cloud API. **World effects:** Reads local paths you pass; fetches http(s) URLs. Uploads file or URL content to mineru.net for processing (do not use for data you must not send off-device). Does not modify or delete originals. May write Markdown (and sometimes images) under `output_dir` or the server default when results are saved or inline content is too large. **Auth & limits:** Without `MINERU_API_TOKEN`, uses free Flash mode: Markdown-only output, service limits apply. With `MINERU_API_TOKEN`, higher per-file page limits and optional extra output formats per MinerU plans; token is read from env (or HTTP Bearer when using streamable HTTP). **Use this when:** The user needs full-document extraction, tables/formulas as HTML/Latexa, batch conversion, or per-file PDF page ranges. **Do not use** for listing supported OCR script codes—call `get_ocr_languages` instead. **Not a substitute** for offline-only or strictly local parsers. **Parameters (intent):** `file_sources` is a list of path/URL strings or `{"source": "…", "pages": "1-5"}` objects (PDF page ranges; Flash allows simple `N` or `N-M`). `enable_ocr` defaults to true. `language` is an OCR/script code (default `ch`); see `get_ocr_languages` for valid values. Set `model` to `"html"` only when every source is a web page URL; otherwise omit. `output_dir` overrides where large or batch results are written.

get_ocr_languages

Return the supported MinerU OCR / script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting `language` on `parse_documents` for scanned or multilingual documents. Do not use for converting files—call `parse_documents` instead.

Ready-to-Paste Client Configurations

Paste either (or both) of these JSON server blocks into your client config file (e.g. claude_desktop_config.json or ~/.cursor/mcp.json).

MinerU Ecosystem Configuration

mcpServers (Claude Desktop / Cursor)

{
  "mcpServers": {
    "opendatalab-mineru-ecosystem": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERUAPITOKEN": "YOUR_MINERUAPITOKEN_HERE"
      }
    }
  }
}

Mineru MCP Configuration

mcpServers (Claude Desktop / Cursor)

{
  "mcpServers": {
    "linxule-mineru-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mineru-mcp"
      ],
      "env": {
        "MINERU_API_KEY": "YOUR_MINERU_API_KEY_HERE"
      }
    }
  }
}

Frequently Asked Questions

MinerU Ecosystem is categorized under Search & Data Extraction and uses a local stdio subprocess. In contrast, Mineru MCP belongs to Search & Data Extraction using local stdio subprocess. Select MinerU Ecosystem when you need capabilities focused on search & data extraction and Mineru MCP when you require tools for search & data extraction.

More alternatives to MinerU Ecosystem More alternatives to Mineru MCP Search & Data Extraction category hub Canonical compare URL