# MinerU Open MCP

> MinerU Open MCP is an open-source MCP server for files and documents. Parse PDFs, images, doc, docx, ppt, pptx, xls, xlsx, html into Markdown using MinerU API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/opendatalab/mineru-ecosystem
- **MCP Registry name:** io.github.opendatalab/mineru-open-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-13

## About

Parse PDFs, images, doc, docx, ppt, pptx, xls, xlsx, html into Markdown using MinerU API.

## Install

### Claude Code (Terminal)

```sh
claude mcp add mineru-open-mcp --env MINERU_API_TOKEN='<MINERU_API_TOKEN>' -- uvx mineru-open-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Is MinerU Open MCP free?

Yes. MinerU Open MCP is open source, so you can use and self-host it for free.

### How do I add MinerU Open MCP to Claude Code?

Run this command in your terminal: claude mcp add mineru-open-mcp --env MINERU_API_TOKEN='<MINERU_API_TOKEN>' -- uvx mineru-open-mcp

### What are the best alternatives to MinerU Open MCP?

The closest alternatives to MinerU Open MCP are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/mineru-open-mcp
