# MinerU Open MCP (MCP server)

> MinerU Open MCP is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Parse PDFs, images, doc, docx, ppt, pptx, xls, xlsx, html into Markdown using MinerU API. It has 220 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx mineru-open-mcp.

The official ecosystem toolkit for MinerU Open API Empowering developers and AI agents with seamless document parsing capabilities — PDF · Word · PPT · Images · Web pages → Markdown / JSON · VLM+OCR dual engine · 109 languages · MCP Server · LangChain / RAGFlow / Dify / FastGPT native integration.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/opendatalab/MinerU-Ecosystem |
| GitHub stars | 220 |
| License | Apache-2.0 |
| Language | Python |
| Transport | stdio |
| Packages | pypi: mineru-open-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | mcp/mcpb/v1.0.21 (Apr 16, 2026) |
| Last commit | Sep 22, 2026 |
| MCP registry name | io.github.opendatalab/mineru-open-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env MINERU_API_TOKEN=your-value --transport stdio mineru-open-mcp -- uvx mineru-open-mcp
```

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

```json
{
  "mcpServers": {
    "mineru-open-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "mineru_api_token",
      "description": "MINERU_API_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "mineru-open-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mineru-open-mcp"
      ],
      "env": {
        "MINERU_API_TOKEN": "${input:mineru_api_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `MINERU_API_TOKEN` (secret): 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.

## Similar MCP servers

- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,368 stars, MIT, official, needs API key)
- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,192 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (7,725 stars, MIT)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create, read and edit Excel workbooks without Microsoft Excel. (4,212 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,108 stars, AGPL-3.0)
- [RevoGrid DataGrid MCP](https://appsgit.com/mcp-servers/revogrid-datagrid-mcp): Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval. (3,448 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/mineru-open-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.