# MinerU Open MCP

Превращает PDF, картинки и файлы Office в Markdown прямо из чата с агентом. Пригодится, когда нужно скормить модели отчёт или статью.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 229
- Автор: opendatalab
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/opendatalab/MinerU-Ecosystem
- Обновлён: 2026-09-22
- HTML: https://affpapa.org/nevibecode/mcp/mineru-open-mcp

## Что делает

MinerU Open MCP — сервер на Python, который даёт агенту доступ к MinerU Open API. Через него Claude, Codex, Cursor и другие клиенты читают PDF, изображения, `doc`, `docx`, `ppt`, `pptx`, `xls`, `xlsx` и `html`, а на выходе получают Markdown. Распознавание формул идёт в LaTeX, таблицы собираются в HTML, колонтитулы отбрасываются, порядок чтения сохраняется.

Внутри два режима. Precision Extract требует токен, тянет до 200 МБ и 200 страниц, умеет пакетную обработку и отдаёт Markdown, JSON или Zip с опциональным экспортом в DOCX, HTML и LaTeX. Quick Parse работает без авторизации, но ограничен 10 МБ и 20 страницами, только Markdown и по одному файлу за раз. Токен передаётся переменной `MINERU_API_TOKEN`, каталог для результатов — `OUTPUT_DIR`.

Запуск идёт через `uvx`, поэтому `uv` должен быть установлен заранее. Без токена сервер поднимется, но упрётся в лимиты быстрого режима — это повод проверить, какой сценарий вам нужен. Для больших сканов и пакетной обработки берите Precision Extract.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `MINERU_API_TOKEN`, `OUTPUT_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MINERU_API_TOKEN=<MINERU_API_TOKEN> --env OUTPUT_DIR=<OUTPUT_DIR> --transport stdio mineru-open-mcp -- uvx mineru-open-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mineru-open-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mineru-open-mcp --env MINERU_API_TOKEN=<MINERU_API_TOKEN> --env OUTPUT_DIR=<OUTPUT_DIR> -- uvx mineru-open-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mineru-open-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mineru-open-mcp": {
            "command": "uvx",
            "args": [
                "mineru-open-mcp"
            ],
            "env": {
                "MINERU_API_TOKEN": "<MINERU_API_TOKEN>",
                "OUTPUT_DIR": "<OUTPUT_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mineru-open-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mineru-open-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mineru-open-mcp"
            ],
            "env": {
                "MINERU_API_TOKEN": "<MINERU_API_TOKEN>",
                "OUTPUT_DIR": "<OUTPUT_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mineru-open-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MINERU_API_TOKEN=<MINERU_API_TOKEN> -e OUTPUT_DIR=<OUTPUT_DIR> mineru-open-mcp uvx mineru-open-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mineru-open-mcp <команда>

## Когда брать
- вытащить текст из PDF со сложной вёрсткой и таблицами
- перевести сканы и рукописные страницы в Markdown
- собрать формулы из научной статьи в LaTeX
- обработать пачку файлов Office за один проход
- отдать агенту содержимое веб-страницы без ручного копирования

## Примеры запросов агенту
- Разбери `report.pdf` и сохрани Markdown в `./output/`
- Распознай таблицы из `paper.pdf` и выгрузи их в HTML
- Спарси эту страницу и покажи текст в Markdown

## Похожие
- [liteparse](https://affpapa.org/nevibecode/skills/liteparse.md) — скилл · 4100 установок
- [paddleocr-doc-parsing](https://affpapa.org/nevibecode/skills/freestylefly-paddleocr-doc-parsing.md) — скилл · 369 установок
- [markitdown](https://affpapa.org/nevibecode/skills/julianobarbosa-markitdown.md) — скилл · 1600 установок
- [markdown-converter](https://affpapa.org/nevibecode/skills/steipete-markdown-converter.md) — скилл · 339 установок
- [PDF OCR Extraction](https://affpapa.org/nevibecode/skills/pdf-ocr-extraction.md) — скилл · 5700 установок
- [nutrient-document-processing](https://affpapa.org/nevibecode/skills/nutrient-document-processing.md) — скилл · 4500 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md