How do I install Mineru?

Mineru is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Mineru safe to use?

Mineru was flagged by MCP Marketplace's security scan, scoring 3.3/10 (high risk). It has 12 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Mineru need?

Mineru requires the following credentials or environment variables: MINERU_URL, MINERU_BACKEND, MINERU_PARSE_METHOD, MINERU_LANG. You can find setup instructions on the server detail page.

What AI apps work with Mineru?

Mineru uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Mineru MCP Server

by GermaniU

Developer ToolsUse Caution3.3LocalNew

Free

Parse PDF, DOCX, PPTX, XLSX and images to Markdown (tables, LaTeX) via a self-hosted MinerU API.

About

Parse PDF, DOCX, PPTX, XLSX and images to Markdown (tables, LaTeX) via a self-hosted MinerU API.

Security Report

3.3

Use Caution3.3High Risk

The MinerU MCP server has no code-level malicious behavior and uses safe subprocess calls with list arguments. Its main concerns are an unauthenticated HTTP mode that binds to 0.0.0.0 with a wildcard CORS policy, unrestricted file_path reads, and a weak prefix-based check that is meant to keep documents on local hosts. Those issues keep the score in the fair range. Supply chain analysis found 15 known vulnerabilities in dependencies (1 critical, 10 high severity).

13 files analyzed · 23 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

process_spawn

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

URL of the mineru-api engine. Only loopback or host.docker.internal is accepted; any other host is treated as external and documents are not sent.Optional

Environment variable: MINERU_URL

Backend used when a call leaves backend empty. pipeline needs the least VRAM; hybrid-engine and vlm-engine need ~4GB.Optional

Environment variable: MINERU_BACKEND

Extraction method used when a call leaves parse_method empty.Optional

Environment variable: MINERU_PARSE_METHOD

OCR language used when a call leaves lang empty.Optional

Environment variable: MINERU_LANG

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-germaniu-mineru-mcp": {
      "env": {
        "MINERU_URL": "your-mineru-url-here",
        "MINERU_LANG": "your-mineru-lang-here",
        "MINERU_BACKEND": "your-mineru-backend-here",
        "MINERU_PARSE_METHOD": "your-mineru-parse-method-here"
      },
      "args": [
        "mineru-mcp"
      ],
      "command": "uvx"
    }
  }
}