Comfy Pilot MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Встроенный терминал Claude Code (xterm.js) внутри ComfyUI
MCP-сервер с прямым доступом к графу (создание узлов, соединение ребер)
Анализ изображения из узлов предварительного просмотра/сохранения изображения
Загрузка моделей с HuggingFace, CivitAI или прямых URL-адресов.
Выборочное обнаружение узла + установка из реестра

Живое демо

Как выглядит на практике

comfy-pilot.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "comfy-pilot",
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "comfy-pilot": {
      "command": {
        "path": "comfy",
        "args": [
          "node",
          "install",
          "comfy-pilot"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add comfy-pilot -- comfy node install comfy-pilot

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Comfy Pilot

Формируйте рабочий процесс SDXL на основе однострочного описания

👤 Пользователи ComfyUI, которые предпочитают описывать, а не перетаскивать ⏱ ~20 min intermediate

Когда использовать: Вы знаете, чего вы хотите от рабочего процесса; вы не хотите тратить 20 минут на его подключение.

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

Установлен ComfyUI + comfy-pilot — удобный узел, установка comfy-pilot
Клод Код CLI — Pilot устанавливает его автоматически, если он отсутствует.

Поток

Открыть пилотную версию в ComfyUI

Откройте терминал Pilot и скажите: «Создайте мне рабочий процесс SDXL для преобразования текста в изображение с контролем глубины ControlNet».✓ Скопировано

→ Граф узлов собирается; модели устанавливаются, если отсутствуют
Запусти это

Запустите рабочий процесс с помощью Prompt='собора, мягкий свет' и моей карты глубины.✓ Скопировано

→ Изображение создано; рабочий процесс сохранен

Итог: Рабочий процесс без размещения 20 узлов вручную.

Подводные камни

Прошу экзотическую модель, которую пилот не может найти. — Укажите URL-адрес репозитория HuggingFace или идентификатор CivitAI; Пилотная версия загружает то, что указано

Сочетать с: comfyui-mcp-server

Рефакторинг существующего запутанного рабочего процесса

👤 Пользователи, чьи рабочие процессы развивались органично ⏱ ~25 min intermediate

Когда использовать: В вашем графе 60 узлов, половина из которых не используется, и вы хотите, чтобы он был чистым.

Поток

Попросите план уборки

Проанализируйте мой текущий график; перечислить мертвые узлы и избыточные ветки.✓ Скопировано

→ Клод читает график через MCP и составляет план
Применять

Примените, но оставьте узел предварительного просмотра в конце.✓ Скопировано

→ Узлы удалены; края перемонтированы; предварительный просмотр нетронутым

Итог: Более чистый и простой в редактировании рабочий процесс.

Подводные камни

Удаление узла, на котором основывался нижестоящий пользовательский код. — Перед деструктивными операциями затрагивайте узлы списка пилотов.

Автоматическая установка пользовательских узлов, необходимых для рабочего процесса

👤 Люди, открывающие сторонние рабочие процессы ⏱ ~10 min beginner

Когда использовать: Вы импортировали рабочий процесс, и ComfyUI сообщает об отсутствии пользовательских узлов.

Поток

Попросите пилота решить проблему

Найдите и установите любые пользовательские узлы, необходимые для этого рабочего процесса.✓ Скопировано

→ Пилотная версия перечисляет недостающие узлы, а затем устанавливает из реестра.
Проверять

Перезагрузите и убедитесь, что график больше не имеет красных границ.✓ Скопировано

→ График проверяется правильно

Итог: Неизвестные рабочие процессы, которые можно использовать без поиска зависимостей.

Подводные камни

Установка неизвестных пользовательских узлов в большом масштабе — Выборочно проверьте исходный код пакета, прежде чем позволить Pilot установить десятки.

Комбинации

Сочетайте с другими MCP — эффект x10

comfy-pilot + comfyui-mcp-server

Пилотные рабочие процессы авторов; сервер MCP запускает их от других клиентов

Попросите Pilot построить рабочий процесс; затем запустите его с Claude Desktop через comfyui-mcp-server.✓ Скопировано

comfy-pilot + filesystem

Организуйте ресурсы и рабочие процессы, создаваемые Pilot

После того как Pilot сохранит рабочий процесс, переместите его в ./workflows/<project>/ с датированным именем.✓ Скопировано

comfy-pilot + mcp-image

Сравните локальные результаты ComfyUI с поколениями Gemini в той же строке.

Запустите ту же подсказку через рабочий процесс Pilot и mcp-образ; дифференцировать результаты.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
graph.list_nodes / graph.get_node	optional filter	Прочитайте текущий рабочий процесс	0
graph.create_node / graph.connect	type, parent, edges	Авторские узлы и ребра проволоки	0
image.analyze	node_id (Preview/Save)	Проверьте сгенерированное изображение, чтобы решить следующий шаг.	0
model.download	source (HF repo, CivitAI id, or URL), target	Отсутствующие контрольно-пропускные пункты/LoRA	bandwidth
nodes.install	custom node package(s)	Отсутствующие или автоматически обязательные пользовательские узлы	bandwidth

Стоимость и лимиты

Во что обходится

Квота API: Только локальные вычисления
Токенов на вызов: Малый (графические операции); Байты изображения/модели доминируют на диске и в пропускной способности
Деньги: Бесплатно; ваш графический процессор + пропускная способность
Совет: Перед загрузкой больших пакетов моделей попросите Pilot подтвердить; многие рабочие процессы имеют общие контрольные точки.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Используйте переменные окружения, если вы добавляете токены HF или CivitAI для более высокой скорости загрузки.

Исходящий трафик: Загрузки с HuggingFace/CivitAI/прямых URL-адресов, которые вы авторизуете; иначе местный.

Установка произвольных пользовательских узлов запускает их код Python. Проверьте исходный код пакета перед автоматической установкой в большом масштабе.
При загрузке модели по прямому URL-адресу можно получать произвольные файлы — отдавайте предпочтение репозиториям HF и идентификаторам CivitAI с известным происхождением.

Устранение неполадок

Частые ошибки и исправления

Пилотный терминал не открывается

Переустановите через удобный узел, установите comfy-pilot; обеспечьте перезапуск ComfyUI.

Проверить: ComfyUI → Manager → Installed, confirm comfy-pilot listed

Установка пользовательского узла не удалась за корпоративным прокси-сервером

Перед запуском установите HTTPS_PROXY в среде процесса ComfyUI.

Проверить: env | grep -i proxy in the ComfyUI terminal

Загрузка модели прерывается на полпути

Возобновите загрузку повторно; Пилот возобновляет воспроизведение с того места, где он остановился, для совместимых источников.

Проверить: Re-run model.download with the same target path

Альтернативы

Comfy Pilot в сравнении

Альтернатива	Когда использовать	Компромисс
comfyui-mcp-server	Вы хотите запускать рабочие процессы от внешних клиентов MCP, а не создавать внутри ComfyUI.	Нет встроенного терминала; другая поверхность
mcp-image	Вы предпочитаете облачный Gemini локальному ComfyUI.	Меньше контроля; платить за изображение
everart	Вам нужны предварительно обученные модели стилей.	Другой провайдер

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills