MinerU Open MCP
Официальный MCP-сервер MinerU: PDF, Word, PowerPoint и изображения превращаются в Markdown с формулами и таблицами
- 229 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Содержимое ваших документов отправляется во внешний API mineru.net и временно кэшируется на его серверах
- Сервер записывает результаты на диск в `OUTPUT_DIR`, а токен `MINERU_API_TOKEN` связывает использование с вашей учетной записью
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mineru-open-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Содержимое ваших документов отправляется во внешний API mineru.net и временно кэшируется на его серверах
- Сервер записывает результаты на диск в `OUTPUT_DIR`, а токен `MINERU_API_TOKEN` связывает использование с вашей учетной записью
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MinerU Open MCP открывает агенту разбор документов через MinerU Open API. Инструмент `parse_documents` принимает локальные файлы и ссылки на удаленные, а возвращает чистый Markdown: формулы идут в LaTeX, таблицы в HTML, колонки собираются в порядке чтения, колонтитулы убираются. Поддержаны PDF, изображения (png, jpg, jp2, webp, gif, bmp), Doc, Docx, Ppt и Pptx, а в быстром режиме еще xlsx. Второй инструмент, `get_ocr_languages`, перечисляет языки распознавания. Ключ не обязателен: быстрый режим работает сразу, бесплатно и без регистрации, но выдает только Markdown и с меньшими лимитами. Токен в `MINERU_API_TOKEN` открывает высокие лимиты и дополнительные форматы. Для одного файла Markdown приходит прямо в чат, для пакета результаты сохраняются на диск в `OUTPUT_DIR` (`~/mineru-downloads` по умолчанию) с метаданными. Можно задать диапазоны страниц для каждого файла отдельно, модель и язык OCR. Работает по stdio и по Streamable HTTP.
Для кого. Тем, кто готовит документы для RAG и разбора: аналитикам, исследователям и разработчикам, которым нужен точный Markdown из научных статей и сканов.
Подходит, если
- Статью с arXiv нужно превратить в Markdown и объяснить таблицы по ссылке без скачивания
- Из PDF берут только страницы 3–5 для разбора главы
- Пачку договоров и отчетов разбирают с отдельными диапазонами страниц на каждый файл
- Скан на корейском или другом языке распознают с нужным языком OCR
Не подходит, если
- Документы конфиденциальны и не должны уходить на внешний сервер: содержимое отправляется в API mineru.net
- Нужна работа без сети: сервер обращается к облачному API
- Нужны исходные макеты и точная верстка: на выходе Markdown и JSON, а не копия оформления
Пример запроса к агенту
Разбери страницы 3–5 этого PDF в Markdown, сохрани формулы в LaTeX и пересчитай таблицу из второй главы в короткий выводMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
MINERU_API_TOKENсекрет- Токен MinerU для высоких лимитов; без него работает быстрый режим
OUTPUT_DIR- Каталог для сохранения результатов, по умолчанию ~/mineru-downloads
Ограничения
Содержимое документов отправляется в официальный API MinerU (mineru.net), результаты временно кэшируются на их серверах и, по заявлению разработчиков, не используются для обучения. В быстром режиме без токена действуют более низкие лимиты и только формат Markdown. Клиенты с песочницей помещают перетащенные файлы во временный каталог, поэтому для локальных файлов нужны полные пути. Журнал пишется только при `ENABLE_LOG=true`. Для запуска нужен `uv`, версия пакета в реестре MCP 1.0.20, лицензия Apache-2.0.
Как отключить. Удалите блок mineru из конфигурации клиента (`claude mcp remove mineru`). Каталог результатов `~/mineru-downloads` очищают вручную.
Частые вопросы
Нужен ли ключ API?
Нет, сервер стартует без ключа. Токен получают на mineru.net и задают в `MINERU_API_TOKEN`, если нужны полные возможности.
Как подключить сервер?
Добавьте в клиент блок с командой `uvx` и аргументом `mineru-open-mcp`, при необходимости с `env` для `MINERU_API_TOKEN`. Для сетевых клиентов `mineru-open-mcp --transport streamable-http --port 8001`.
Куда сохраняются результаты?
Для пакетной обработки и крупного вывода в каталог `OUTPUT_DIR`, по умолчанию `~/mineru-downloads`. Ответ содержит метаданные файлов и ссылку на архив.
Какие форматы входа поддержаны?
PDF, изображения png, jpg, jpeg, jp2, webp, gif и bmp, а также Doc, Docx, Ppt и Pptx. Файлы xlsx принимает быстрый режим.
Что входит в репозиторий MinerU-Ecosystem?
Консольная утилита, SDK на Python, Go и TypeScript, загрузчики для LangChain и LlamaIndex, MCP-сервер и скиллы для агентов вроде Claude Code.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСкилл и CLI без ключа и зависимостей: превращает PDF, Office и картинки в Markdown через облако MinerU.
MinerU — CLI с библиотекой документов: уже разобранный отчет можно искать и читать повторно из локального кеша.
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MinerU PDF Translate переводит научные PDF на другой язык с формулами и рисунками и отдает готовый PDF.
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Порт docling на Rust превращает PDF, Office, HTML и сканы в Markdown и JSON одним бинарником, с режимом MCP-сервера
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MinerU Open MCP (эта карточка) | да | ключ необязателен | 229 | |
| MarkItDown | да | не нужна | 195 183 | утилита Microsoft для разных форматов в Markdown, а не облачный разбор формул, таблиц и сканов MinerU |
| MinerU Skill | нет | не нужна | 133 | скилл и CLI без ключа для тех же PDF, а не MCP-сервер с диапазонами страниц и выбором модели |
Коротко о README
Текст представляет репозиторий как набор инструментов вокруг MinerU Open API: консольная утилита, SDK, интеграции с LangChain, LlamaIndex, RAGFlow, Dify и FastGPT, MCP-сервер и скиллы. Описаны два режима API, точный и быстрый, а раздел про MCP отсылает к `mcp/README.md`.