MinerU Open MCP — MCP-сервер для Claude Code: парсинг документов
Превращает PDF, картинки и файлы Office в Markdown прямо из чата с агентом. Пригодится, когда нужно скормить модели отчёт или статью.
claude mcp add --env MINERU_API_TOKEN=<MINERU_API_TOKEN> --env OUTPUT_DIR=<OUTPUT_DIR> --transport stdio mineru-open-mcp -- uvx mineru-open-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.
Какие задачи решает
- вытащить текст из PDF со сложной вёрсткой и таблицами
- перевести сканы и рукописные страницы в Markdown
- собрать формулы из научной статьи в LaTeX
- обработать пачку файлов Office за один проход
- отдать агенту содержимое веб-страницы без ручного копирования
Примеры запросов агенту
- Разбери
report.pdfи сохрани Markdown в./output/ - Распознай таблицы из
paper.pdfи выгрузи их в HTML - Спарси эту страницу и покажи текст в Markdown
Как установить MinerU Open MCP
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MinerU Open MCP
Как установить MinerU Open MCP в Claude?
Выполните claude mcp add mineru-open-mcp -e MINERU_API_TOKEN=<MINERU_API_TOKEN> -- uvx mineru-open-mcp. Если нужен свой каталог для результатов, используйте вариант с --env MINERU_API_TOKEN=<MINERU_API_TOKEN> --env OUTPUT_DIR=<OUTPUT_DIR> --transport stdio.
Что делает MinerU Open MCP?
Даёт агенту инструмент для разбора документов через MinerU Open API: PDF, изображения, файлы Office и HTML превращаются в Markdown или JSON.
Чем Precision Extract отличается от Quick Parse?
Precision Extract требует токен, принимает файлы до 200 МБ и 200 страниц, поддерживает пакетную обработку и несколько форматов вывода. Quick Parse работает без авторизации, но ограничен 10 МБ, 20 страницами и одним файлом.
