Прямое управление графом через MCP
Стандартный HTTP API ComfyUI ограничен управлением очередью и файлами, но не видит состояние открытого в браузере графа. Проект comfyui-mcp решает эту проблему, используя WebSocket-соединение для создания канала запрос-ответ. Это позволяет AI-ассистенту не только запускать готовые воркфлоу, но и читать живой граф, изменять значения виджетов, переподключать узлы, менять лейблы и делать скриншоты холста в реальном времени.
Ключевая особенность — наличие «мостового» узла (bridge node), который синхронизирует состояние интерфейса с сервером. Без него ассистент работает только с сохраненными файлами, с ним — управляет текущей сессией, включая несохраненные изменения.
45 инструментов для полного контроля
Сервер предоставляет обширный набор инструментов, разделенных на логические группы. Ассистент может диагностировать проблемы, управлять моделями и контролировать процесс генерации. Ниже приведена структура доступных функций:
| Группа инструментов | Функциональность |
|---|---|
| Статус и работа | Проверка доступности ComfyUI, мониторинг VRAM, состояние очереди, управление процессами (старт/стоп/перезапуск) |
| Воркфлоу и справка | Список файлов, анализ параметров, поиск по каталогу узлов, чтение схем узлов, получение текстовых инструкций (.md) |
| Чтение холста (Canvas) | Получение живого графа, скриншоты, диагностика ошибок, проверка открытых вкладок |
| Редактирование холста | Изменение значений виджетов, свойств, лейблов, переподключение связей, изменение режимов узлов, группировка, отмена действий |
| Запуск генерации | Запуск файла или текущего холста, отслеживание прогресса, получение результата, отображение изображения |
| Загрузка моделей | Скачивание моделей в директорию ComfyUI с прогрессом и проверкой безопасности |
Безопасность и контроль загрузок
Поскольку проект работает локально, безопасность критична. Сервер внедряет строгие проверки для инструмента download_model, чтобы предотвратить выполнение вредоносного кода через ссылки в воркфлоу:
- Блокировка хостов: Загрузка разрешена только с доменов, указанных в переменной
COMFYUI_DOWNLOAD_ALLOW_HOSTS. - Защита от pickle: Форматы
.ckpt,.pt,.pth,.bin,.pklзаблокированы по умолчанию (риск выполнения кода). Разрешены только.safetensorsи.gguf, если не отключена опцияCOMFYUI_DOWNLOAD_ALLOW_PICKLE. - Контроль токенов: Токен доступа передается только целевому хосту, цепочка редиректов обрабатывается вручную, чтобы токен не утек на CDN.
Интеграция с клиентами и установка
Проект поддерживает 11 MCP-клиентов «из коробки», включая Claude Code, Cursor, Kilo Code, LM Studio, Cherry Studio и другие. Утилита configure_clients.sh автоматически генерирует конфигурацию с правильными путями и форматами, не перезаписывая существующие настройки.
Установка требует только Python (через uv) и не требует прав администратора. Сервер использует лицензию GPL-3.0, что соответствует лицензии самого ComfyUI. Поддерживается двуязычный интерфейс (English/Russian) для установщика и документации, хотя описания инструментов для модели остаются на английском языке.
Источник: Github ↗