This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Конфигурация

Страница описывает систему управления параметрами MinerU MCP Server. Вся конфигурация осуществляется через переменные окружения и централизованно загружается в класс Settings в файле src/mineru_mcp/config.py.

Переменные окружения

Ниже приведено описание ключевых переменных, определяющих поведение сервиса.

Подключение к MinerU

Эти параметры отвечают за взаимодействие с внешним API MinerU.

Переменная	Описание	Значение по умолчанию
MINERU_URL	Адрес API MinerU. Используется для отправки задач и получения результатов.	http://mineru:8000
MINERU_BACKEND	Имя бэкенда для обработки документов. Влияет на качество и скорость OCR.	hybrid-engine
MINERU_LANG_LIST	Список языков для улучшения распознавания текста. Задается через запятую.	cyrillic

Детали реализации:

• URL формируется в методе submit_parse_task() для отправки файлов.
• Бэкенд и языки передаются в теле POST-запроса вместе с файлом.

Таймауты и производительность

Параметры, влияющие на асинхронный цикл обработки и ожидание ответа от MinerU.

Переменная	Описание	Значение по умолчанию
MCP_TIMEOUT_SECONDS	Максимальное время ожидания выполнения задачи MinerU.	600 (10 минут)
MCP_POLL_INTERVAL_SECONDS	Интервал между запросами статуса задачи (поллинг).	5 (секунд)

Примечание: Логика поллинга реализована в функции wait_for_task_completion(). Она циклически проверяет статус задачи, используя указанные интервалы, пока задача не завершится или не истечет таймаут.

Логирование и сеть

Переменная	Описание	Значение по умолчанию
LOG_LEVEL	Уровень детализации логов (DEBUG, INFO, WARNING, ERROR).	INFO
MCP_PORT	Порт, на котором слушает сервер.	8001

Примеры конфигурации

Docker Compose

Основной способ запуска сервиса. Переменные задаются в блоке environment:

services:
  mineru-mcp:
    image: mineru-mcp:latest
    environment:
      - MINERU_URL=http://mineru:8000
      - MINERU_BACKEND=hybrid-engine
      - MINERU_LANG_LIST=cyrillic,east_slavic
      - MCP_TIMEOUT_SECONDS=600
      - LOG_LEVEL=DEBUG

Подробнее о запуске см. в разделе Быстрый старт.

Локальная разработка

При запуске без Docker используйте экспорт переменных в терминале:

export MINERU_URL=http://localhost:8000
export MINERU_BACKEND=pipeline
export MCP_PORT=8001
PYTHONPATH=src python -m mineru_mcp.main

Инструкция по локальному запуску доступна в разделе Разработка.

Рекомендации по настройке

1. Выбор бэкенда (MINERU_BACKEND):

   • hybrid-engine: Оптимальный баланс скорости и качества для большинства документов.
   • pipeline: Рекомендуется для сложных документов с большим количеством таблиц или рукописного текста, особенно если указан специфический язык.

2. Языковые модели (MINERU_LANG_LIST):

   • Для документов на русском и казахском языках используйте cyrillic или east_slavic.
   • Для китайских документов — ch.
   • Можно комбинировать значения через запятую, например: cyrillic,ch.

3. Отладка:

   • Если парсинг зависает или завершается ошибкой таймаута, увеличьте MCP_TIMEOUT_SECONDS.
   • Для анализа причин ошибок установите LOG_LEVEL=DEBUG.

4. Безопасность:

   • Не забывайте настраивать переменную MCP_API_KEY для защиты endpoints, если сервис открыт в сеть. Подробнее об этом см. в разделе Устранение неполадок.