MinerU MCP

Name: MinerU MCP
Author: OpenDataLab

OpenDataLabOfficialChina

Get started Repository

Lets agents use MinerU to parse PDFs, Word, PPT and images into LLM-ready Markdown or JSON.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add mineru --env LOCAL_MINERU_API_BASE='<LOCAL_MINERU_API_BASE>' --env MINERU_API_BASE='<MINERU_API_BASE>' --env MINERU_API_KEY='<MINERU_API_KEY>' --env OUTPUT_DIR='<OUTPUT_DIR>' --env USE_LOCAL_API='<USE_LOCAL_API>' -- uvx mineru-mcp

~/.codex/config.toml

[mcp_servers.mineru]
command = "uvx"
args = ["mineru-mcp"]
env = { LOCAL_MINERU_API_BASE = "<LOCAL_MINERU_API_BASE>", MINERU_API_BASE = "<MINERU_API_BASE>", MINERU_API_KEY = "<MINERU_API_KEY>", OUTPUT_DIR = "<OUTPUT_DIR>", USE_LOCAL_API = "<USE_LOCAL_API>" }

# codex mcp add mineru --env LOCAL_MINERU_API_BASE='<LOCAL_MINERU_API_BASE>' --env MINERU_API_BASE='<MINERU_API_BASE>' --env MINERU_API_KEY='<MINERU_API_KEY>' --env OUTPUT_DIR='<OUTPUT_DIR>' --env USE_LOCAL_API='<USE_LOCAL_API>' -- uvx mineru-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": [
        "mineru-mcp"
      ],
      "env": {
        "LOCAL_MINERU_API_BASE": "<LOCAL_MINERU_API_BASE>",
        "MINERU_API_BASE": "<MINERU_API_BASE>",
        "MINERU_API_KEY": "<MINERU_API_KEY>",
        "OUTPUT_DIR": "<OUTPUT_DIR>",
        "USE_LOCAL_API": "<USE_LOCAL_API>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mineru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mineru-mcp"
      ],
      "env": {
        "LOCAL_MINERU_API_BASE": "<LOCAL_MINERU_API_BASE>",
        "MINERU_API_BASE": "<MINERU_API_BASE>",
        "MINERU_API_KEY": "<MINERU_API_KEY>",
        "OUTPUT_DIR": "<OUTPUT_DIR>",
        "USE_LOCAL_API": "<USE_LOCAL_API>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": [
        "mineru-mcp"
      ],
      "env": {
        "LOCAL_MINERU_API_BASE": "<LOCAL_MINERU_API_BASE>",
        "MINERU_API_BASE": "<MINERU_API_BASE>",
        "MINERU_API_KEY": "<MINERU_API_KEY>",
        "OUTPUT_DIR": "<OUTPUT_DIR>",
        "USE_LOCAL_API": "<USE_LOCAL_API>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": [
        "mineru-mcp"
      ],
      "env": {
        "LOCAL_MINERU_API_BASE": "<LOCAL_MINERU_API_BASE>",
        "MINERU_API_BASE": "<MINERU_API_BASE>",
        "MINERU_API_KEY": "<MINERU_API_KEY>",
        "OUTPUT_DIR": "<OUTPUT_DIR>",
        "USE_LOCAL_API": "<USE_LOCAL_API>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": [
        "mineru-mcp"
      ],
      "env": {
        "LOCAL_MINERU_API_BASE": "<LOCAL_MINERU_API_BASE>",
        "MINERU_API_BASE": "<MINERU_API_BASE>",
        "MINERU_API_KEY": "<MINERU_API_KEY>",
        "OUTPUT_DIR": "<OUTPUT_DIR>",
        "USE_LOCAL_API": "<USE_LOCAL_API>"
      }
    }
  }
}

Environment variables

LOCAL_MINERU_API_BASE
MINERU_API_BASE
MINERU_API_KEY
OUTPUT_DIR
USE_LOCAL_API

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related