mineru-selfhosted-mcp 0.1.4

MCP bridge for a self-hosted MinerU API

mineru-selfhosted-mcp

mineru-selfhosted-mcp exposes a self-hosted MinerU service as an MCP server.

It is designed for setups where:

• MinerU is deployed on a remote GPU server
• Claude Desktop / Cursor / other MCP clients run elsewhere
• The client should only run a lightweight MCP bridge locally

Environment variables

• MINERU_BASE_URL: Optional. Base URL of your self-hosted MinerU API. Defaults to http://42.51.34.112:8191
• MINERU_API_TOKEN: Optional token sent to the MinerU API as Authorization: Bearer <token>
• MINERU_TIMEOUT: Optional request timeout in seconds. Default: 1800
• MINERU_TRUST_ENV: Optional. Set to true only if you want the bridge to inherit local proxy variables. Default: disabled.
• MINERU_LOG_DIR: Optional. Directory used by clean_logs. Defaults to ~/.mineru-selfhosted-mcp/logs

Exposed tools

• mineru_health: check the remote MinerU API
• parse_document: parse a single local file through the remote MinerU API
• parse_documents: parse one or more local files through the remote MinerU API
• get_ocr_languages: list common OCR language codes supported by MinerU
• clean_logs: remove local MCP log files older than a chosen number of days

Example MCP config

{
  "mcpServers": {
    "mineru-selfhosted": {
      "command": "uvx",
      "args": ["mineru-selfhosted-mcp"],
      "env": {
        "MINERU_API_TOKEN": "your_token"
      }
    }
  }
}