Human-In-the-Loop MCP сервер

Мощный MCP сервер, который позволяет AI-ассистентам вроде Claude взаимодействовать с людьми через интуитивно понятные GUI-диалоги, устраняя разрыв между автоматизированными AI-процессами и человеческим принятием решений за счет предоставления инструментов для получения пользовательского ввода в реальном времени, выбора вариантов, подтверждений и механизмов обратной связи.

Установка

uvx (Рекомендуется)

uvx hitl-mcp-server

PyPI

pip install hitl-mcp-server

Разработка

git clone https://github.com/GongRzhe/Human-In-the-Loop-MCP-Server.git
cd Human-In-the-Loop-MCP-Server
pip install -e .

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

Claude Desktop (uvx)

{
  "mcpServers": {
    "human-in-the-loop": {
      "command": "uvx",
      "args": ["hitl-mcp-server"]
    }
  }
}

Claude Desktop (pip)

{
  "mcpServers": {
    "human-in-the-loop": {
      "command": "hitl-mcp-server",
      "args": []
    }
  }
}

Доступные инструменты

Инструмент	Описание
`get_user_input`	Получение однострочного текста, чисел или других данных от пользователей с валидацией
`get_user_choice`	Представление множественных опций для одиночного или множественного выбора пользователем
`get_multiline_input`	Сбор длинного текстового контента, кода или детальных описаний
`show_confirmation_dialog`	Запрос подтверждения да/нет перед выполнением действий
`show_info_message`	Отображение информации, уведомлений, обновлений статуса и результатов
`health_check`	Мониторинг статуса сервера и доступности GUI

Возможности

Интерактивный ввод текста с валидацией для текста, чисел или других данных
Диалоги множественного выбора для одиночного или множественного выбора
Сбор многострочного ввода для длинного контента или кода
Диалоги подтверждения для решений да/нет
Информационные сообщения для уведомлений и обновлений статуса
Современный кроссплатформенный GUI (стиль Windows 11, нативный macOS, совместимость с Linux)
Неблокирующая работа с отдельными потоками
Защита от таймаутов с настраиваемыми 5-минутными таймаутами
Определение платформы с автоматической оптимизацией
Комплексная обработка ошибок и корректное восстановление

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

Опциональные

HITL_DEBUG - Включение детального логирования для отладки

Примеры использования

Получение информации о настройке проекта от пользователя

Предложение пользователю выбрать между вариантами фреймворков

Сбор детального фидбека или комментариев к ревью кода

Подтверждение перед выполнением потенциально разрушительных действий

Отображение уведомлений о завершении процессов

Ресурсы

GitHub Repository

Примечания

Пользователям macOS может потребоваться предоставить разрешения доступности в System Preferences > Security & Privacy > Accessibility. Требует среду рабочего стола (не headless). Расположение конфигурационных файлов различается по платформам: Windows (%APPDATA%\Claude\claude_desktop_config.json), macOS (~/Library/Application Support/Claude/claude_desktop_config.json), Linux (~/.config/Claude/claude_desktop_config.json).