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. Сервер предоставляет LLM-агентам возможность извлекать текст из документов через стандартизированный протокол MCP.

Предварительные требования

Убедитесь, что на вашем сервере установлены следующие инструменты:

• Docker и Docker Compose
• Доступ к работающему экземпляру MinerU (локальному или удаленному)

1. Клонирование репозитория

Выполните команду для загрузки исходного кода:

git clone https://git.maydayoffice.kz/maydayoffice/mineru-mcp-server.git
cd mineru-mcp-server

2. Настройка переменных окружения

Конфигурация контейнера осуществляется через файл docker-compose.yml.

Откройте файл и убедитесь, что параметр MINERU_URL указывает на ваш сервис MinerU. Если MinerU запущен в той же Docker-сети, оставьте значение по умолчанию http://mineru:8000 (предварительно раскомментировав сервис mineru в файле). Если MinerU находится на другом хосте, замените URL на доступный адрес (например, http://host.docker.internal:8000 или внешний IP).

Основные параметры конфигурации:

Переменная	Описание	Пример значения
MINERU_URL	Адрес API MinerU	http://mineru:8000
MINERU_BACKEND	Метод парсинга	hybrid-engine
MINERU_LANG_LIST	Языки OCR	cyrillic
MCP_TIMEOUT_SECONDS	Таймаут задачи	600
LOG_LEVEL	Уровень логов	INFO

Подробное описание всех переменных доступно в разделе Конфигурация.

3. Запуск через Docker Compose

Запустите сервис в фоновом режиме:

docker-compose up -d

Проверьте статус контейнеров и просмотрите логи:

docker-compose ps
docker-compose logs -f mineru-mcp

Успешный запуск сопровождается сообщением о том, что сервер слушает порт 8001.

4. Проверка работоспособности

После запуска сервер доступен по адресу http://localhost:8001/mcp.

Тестирование через curl

Для проверки работоспособности можно использовать ручное тестирование через curl, описанное в разделе Тестирование. Краткий пример инициализации сессии:

curl -v -X POST http://localhost:8001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "test-client",
        "version": "1.0"
      }
    }
  }'

Интеграция с LiteLLM

Если вы используете LiteLLM как шлюз для агентов, добавьте конфигурацию MCP-сервера в ваш YAML-файл. Подробнее см. в разделе Интеграция с LiteLLM.

Что дальше?

• Узнайте больше о структуре ответа и параметрах инструмента parse_document в Документации API.
• Изучите архитектуру взаимодействия с MinerU и механизм поллинга в разделе Архитектура.
• Если возникнут проблемы с запуском или подключением, обратитесь к разделу Устранение неполадок.
• Для локальной разработки без Docker ознакомьтесь с разделом Разработка.