Docling MCP — MCP-сервер для Claude Code: конвертация PDF
Превращает PDF и другие документы в структурированный JSON прямо в чате агента. Пригодится, когда надо разобрать отчёт или статью для дальнейшей обработки.
claude mcp add --env DOCLING_MCP_CONVERSION_MODE=<DOCLING_MCP_CONVERSION_MODE> --env DOCLING_MCP_SERVICE_URL=<DOCLING_MCP_SERVICE_URL> --env DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> --env DOCLING_MCP_SERVICE_TIMEOUT=<DOCLING_MCP_SERVICE_TIMEOUT> --env DOCLING_MCP_SERVICE_MAX_RETRIES=<DOCLING_MCP_SERVICE_MAX_RETRIES> --transport stdio docling-mcp -- uvx docling-mcpЧто делает Docling MCP
Docling MCP оборачивает библиотеку Docling в набор инструментов, которые клиент вызывает по протоколу MCP. Основная задача — конвертация PDF в структурированный JSON формата DoclingDocument, плюс генерация документов с экспортом в разные форматы. Есть локальный кэш, чтобы не гонять один и тот же файл дважды, и поддержка источников в виде локальных путей или URL.
Работает в трёх режимах. Remote обращается к внешнему Docling Serve по URL и ключу API, local считает всё на машине, hybrid пробует удалённый сервис и падает на локальный, если тот недоступен. Режим задаётся переменной DOCLING_MCP_CONVERSION_MODE, по умолчанию стоит remote — значит, без DOCLING_MCP_SERVICE_URL и DOCLING_MCP_SERVICE_API_KEY сервер не заработает. Для локального режима ставьте пакет с extra local.
Отдельно стоит флаг DOCLING_MCP_DO_PICTURE_DESCRIPTION: он включает модель описания картинок, и на слабом железе конвертация может заметно замедлиться. Если упираетесь в таймаут, увеличивайте DOCLING_MCP_SERVICE_TIMEOUT — по умолчанию 300.0 секунд. Клиент тоже умеет обрывать запрос раньше, так что проверьте его настройки.
Какие задачи решает
- вытащить текст и таблицы из PDF в структурированный JSON
- скормить агенту локальный файл или ссылку на документ
- собрать документ в DoclingDocument и выгрузить в нужный формат
- загрузить разобранные документы в Milvus для RAG
- не пересчитывать один и тот же файл благодаря кэшу
Примеры запросов агенту
- Сконвертируй
report.pdfв DoclingDocument и покажи структуру таблиц - Возьми документ по ссылке и выгрузи его в markdown
- Собери DoclingDocument из этих данных и экспортируй в JSON
Как установить Docling MCP
Командой платформы
claude mcp add --env DOCLING_MCP_CONVERSION_MODE=<DOCLING_MCP_CONVERSION_MODE> --env DOCLING_MCP_SERVICE_URL=<DOCLING_MCP_SERVICE_URL> --env DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> --env DOCLING_MCP_SERVICE_TIMEOUT=<DOCLING_MCP_SERVICE_TIMEOUT> --env DOCLING_MCP_SERVICE_MAX_RETRIES=<DOCLING_MCP_SERVICE_MAX_RETRIES> --transport stdio docling-mcp -- uvx docling-mcpВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from docling-mcp <команда>
Командой платформы
codex mcp add docling-mcp --env DOCLING_MCP_CONVERSION_MODE=<DOCLING_MCP_CONVERSION_MODE> --env DOCLING_MCP_SERVICE_URL=<DOCLING_MCP_SERVICE_URL> --env DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> --env DOCLING_MCP_SERVICE_TIMEOUT=<DOCLING_MCP_SERVICE_TIMEOUT> --env DOCLING_MCP_SERVICE_MAX_RETRIES=<DOCLING_MCP_SERVICE_MAX_RETRIES> -- uvx docling-mcpВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from docling-mcp <команда>
Файл настроек
{
"mcpServers": {
"docling-mcp": {
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_CONVERSION_MODE": "<DOCLING_MCP_CONVERSION_MODE>",
"DOCLING_MCP_SERVICE_URL": "<DOCLING_MCP_SERVICE_URL>",
"DOCLING_MCP_SERVICE_API_KEY": "<DOCLING_MCP_SERVICE_API_KEY>",
"DOCLING_MCP_SERVICE_TIMEOUT": "<DOCLING_MCP_SERVICE_TIMEOUT>",
"DOCLING_MCP_SERVICE_MAX_RETRIES": "<DOCLING_MCP_SERVICE_MAX_RETRIES>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from docling-mcp <команда>
Файл настроек
{
"servers": {
"docling-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_CONVERSION_MODE": "<DOCLING_MCP_CONVERSION_MODE>",
"DOCLING_MCP_SERVICE_URL": "<DOCLING_MCP_SERVICE_URL>",
"DOCLING_MCP_SERVICE_API_KEY": "<DOCLING_MCP_SERVICE_API_KEY>",
"DOCLING_MCP_SERVICE_TIMEOUT": "<DOCLING_MCP_SERVICE_TIMEOUT>",
"DOCLING_MCP_SERVICE_MAX_RETRIES": "<DOCLING_MCP_SERVICE_MAX_RETRIES>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from docling-mcp <команда>
Командой платформы
gemini mcp add -e DOCLING_MCP_CONVERSION_MODE=<DOCLING_MCP_CONVERSION_MODE> -e DOCLING_MCP_SERVICE_URL=<DOCLING_MCP_SERVICE_URL> -e DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> -e DOCLING_MCP_SERVICE_TIMEOUT=<DOCLING_MCP_SERVICE_TIMEOUT> -e DOCLING_MCP_SERVICE_MAX_RETRIES=<DOCLING_MCP_SERVICE_MAX_RETRIES> docling-mcp uvx docling-mcpВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from docling-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Docling MCP
Как установить Docling MCP в Claude?
Добавьте сервер командой claude mcp add docling-mcp -e DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> -- uvx docling-mcp. Для полного набора переменных есть вариант с `--env DOCLING_MCP_CONVERSION_MODE=<DOCLING_MCP_CONVERSION_MODE> --env DOCLING_MCP_SERVICE_URL=<DOCLING_MCP_SERVICE_URL> --env DOCLING_MCP_SERVICE_API_KEY=<DOCLING_MCP_SERVICE_API_KEY> --env DOCLING_MCP_SERVICE_TIMEOUT=<DOCLING_MCP_SERVICE_TIMEOUT> --env DOCLING_MCP_SERVICE_MAX_RETRIES=<DOCLING_MCP_SERVICE_MAX_RETRIES> --transport stdio docling-mcp -- uvx docling-mcp`.
Что делает Docling MCP?
Даёт агенту инструменты для конвертации PDF в структурированный JSON и для генерации документов. Результат можно экспортировать в разные форматы, а готовые данные — отправить в Milvus.
Что нужно для работы в режиме remote?
URL сервиса Docling Serve и ключ API — переменные DOCLING_MCP_SERVICE_URL и DOCLING_MCP_SERVICE_API_KEY. Без них режим remote, который стоит по умолчанию, не запустится.
