MinerU Open MCP Server

by opendatalabio.github.opendatalab/mineru-open-mcpv1.0.20

Convert PDFs, Word and PowerPoint files, images and spreadsheets to Markdown via the MinerU document parsing API.

221Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active18d ago

Install MinerU Open MCP server

claude mcp add mineru-open -e MINERU_API_TOKEN='<mineru-api-token>' -- uvx mineru-open-mcp

{
  "mcpServers": {
    "mineru-open": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "<mineru-api-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mineru-open": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "<mineru-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mineru-open": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "<mineru-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mineru-open": {
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "<mineru-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MINERU_API_TOKEN	—	yes	MinerU API token for full capability (higher limits, extra output formats). Omit to use free Flash mode (Markdown only, 20 pages / 10 MB per file).
OUTPUT_DIR	—	—	Directory for saved parse results when content is written to disk.

Freshness

Active — last maintenance signal 18d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-22 · 18d ago · GitHub
Latest release
2026-04-16 · 6mo ago · GitHub · mcp/mcpb/v1.0.21
Package published
no data · npm/PyPI
Registry entry updated
2026-04-13 · 6mo ago · official registry · v1.0.20

FAQ

›How do I install the MinerU Open MCP server in Claude Code?

Run: claude mcp add mineru-open -e MINERU_API_TOKEN='<mineru-api-token>' -- uvx mineru-open-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MinerU Open require an API key?

Yes. It expects MINERU_API_TOKEN, of which 1 is a secret.

›Can I use MinerU Open as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MinerU Open in the official MCP registry?

Yes, as io.github.opendatalab/mineru-open-mcp.