MinerU — MCP-сервер для Claude Code: разбор и установка
MCP-сервер отправляет PDF, изображения, DOCX и PPTX в MinerU для разбора, OCR и пакетной обработки. Нужен для получения структурированного текста и Markdown.
claude mcp add mineru -- npx -y mineru-mcpЧто делает MinerU
MinerU подключает к агенту инструменты MinerU для разбора документов по URL и загрузки локальных файлов. Сервер умеет проверять статус задач, обрабатывать несколько документов, выбирать страницы и получать результаты с исходными именами файлов. Для длинных документов есть разбиение по диапазонам страниц и сборка Markdown-фрагментов.
В набор также входят операции с локальным журналом, возобновлением и сохранёнными пакетами результатов. Команды API требуют ключ MINERU_API_KEY, а создание офлайн-пакета может работать без учётных данных. Локальное хранение результатов, пакеты и журналируемые операции рассчитаны на macOS или Linux: в Windows эти пути завершаются ошибкой.
Пакет можно подключить через npx. На новых установках рекомендуется Node.js 24, при этом поддерживается Node.js 18 и выше.
Какие задачи решает
- разобрать PDF, DOCX или PPTX по URL
- загрузить локальные файлы для пакетной обработки
- извлечь Markdown только из выбранных страниц
- проверить статус задачи и получить ссылку на результат
- собрать части длинного документа в единый Markdown
Примеры запросов агенту
- Разбери PDF по этой ссылке и верни результат в Markdown.
- Загрузи локальные документы для пакетной обработки и сохрани результаты с исходными именами.
- Обработай длинный документ частями по диапазонам страниц, затем объедини доступные фрагменты.
Как установить MinerU
Командой платформы
claude mcp add mineru -- npx -y mineru-mcpКомандой платформы
codex mcp add mineru -- npx -y mineru-mcpФайл настроек
{
"mcpServers": {
"mineru": {
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Файл настроек
{
"servers": {
"mineru": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mineru-mcp"
]
}
}
}Командой платформы
gemini mcp add mineru npx -y mineru-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MinerU
Как установить MinerU в Claude Code?
Выполните claude mcp add mineru -- npx -y mineru-mcp. Для облачных операций задайте ключ MINERU_API_KEY.
Что делает MinerU?
Сервер передаёт документы в MinerU, отслеживает задачи и возвращает результаты разбора. Он поддерживает OCR, пакетную обработку, диапазоны страниц и разбор длинных документов.
Что нужно для работы MinerU?
Облачные команды требуют API-ключ MinerU. Для новых установок рекомендуется Node.js 24, а локальное хранение результатов и журналируемые операции работают на macOS или Linux.
