/ Каталог / Песочница / ComfyUI MCP Server
● Сообщество joenorton 🔑 Нужен свой ключ

ComfyUI MCP Server

автор joenorton · joenorton/comfyui-mcp-server

Локальный ComfyUI как инструмент MCP — создавайте изображения, аудио и видео, запускайте рабочие процессы и управляйте ресурсами, не открывая пользовательский интерфейс ComfyUI.

comfyui-mcp-server соединяет локально работающий ComfyUI (порт 8188) с любым клиентом MCP. Агенты могут создавать и восстанавливать изображения, отправлять пользовательские рабочие процессы, опрашивать и отменять задания, просматривать сгенерированные ресурсы, переключать модели и публиковать результаты — и все это с помощью инструментов MCP. Полезно для итеративной творческой работы, пакетной генерации и запуска программного конвейера, когда вы не хотите перетаскивать узлы вручную.

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

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

Живое демо

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

comfyui-mcp-server.replay ▶ готово
0/0

Установка

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

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

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

claude mcp add comfyui-mcp-server -- python server.py

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

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

Реальные сценарии: ComfyUI MCP Server

Итерация концепции изображения с помощью текстовых подсказок

👤 Дизайнеры и художники, использующие ComfyUI локально ⏱ ~20 min intermediate

Когда использовать: У вас настроен ComfyUI, но вы хотите выполнять итерацию через чат, а не через графы узлов.

Предварительные требования
  • ComfyUI работает на порту 8188 — Следуйте инструкциям по установке ComfyUI; убедитесь, что модель контрольной точки находится в папке models/checkpoints/
  • MCP-сервер запущен — python server.py (прослушивается по адресу http://127.0.0.1:9000/mcp)
Поток
  1. Создать версию 1
    Создайте изображение: фотореалистичный портрет, пасмурный свет, 1024×1280.✓ Скопировано
    → Работа отправлена; идентификатор вернулся; изображение появится, когда закончите
  2. Регенерация с настройками
    Возродитесь из этого семени — чуть более теплые тона, сохраните композицию.✓ Скопировано
    → Тот же состав, более теплые цвета.
  3. Посмотреть + опубликовать
    Посмотреть последнее изображение; опубликуйте его в галерее как «portrait-final.png».✓ Скопировано
    → Метаданные актива + URL публикации

Итог: Быстрая итерация без щелчка узлов.

Подводные камни
  • Забываем, что ComfyUI должен быть запущен до запуска сервера MCP. — Сначала запустите ComfyUI, затем сервер MCP.
Сочетать с: filesystem

Запустите сохраненный рабочий процесс ComfyUI из чата.

👤 Команды с устоявшимися рабочими процессами ComfyUI ⏱ ~15 min intermediate

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

Предварительные требования
  • Рабочий процесс, сохраненный в ComfyUI. — Сохранить как → рабочий процесс JSON
Поток
  1. Получение списка рабочих процессов
    Перечислите мои рабочие процессы.✓ Скопировано
    → Массив с именами/идентификаторами
  2. Запусти это
    Запустите «product-shot-v3» с позитивным = «керамическая кружка на мраморе», негативным = «размытым».✓ Скопировано
    → Работа создана; параметры отражены
  3. Подождите + получите результат
    Сообщите мне, когда оно закончится, и покажите изображение.✓ Скопировано
    → Очередь опросов; возвращает актив после завершения

Итог: Управление рабочим процессом из чата — идеально подходит для пакетных запусков.

Подводные камни
  • Рабочий процесс ссылается на пользовательские узлы, которые не установлены. — Перед запуском установите необходимые пользовательские узлы в ComfyUI.
Сочетать с: comfy-pilot

Превратите короткий сценарий в видео с помощью рабочего процесса для видео

👤 Создатели контента, создающие короткометражки ⏱ ~45 min advanced

Когда использовать: У вас есть рабочий процесс видео ComfyUI (например, AnimateDiff/Mochi) и вы хотите последовательно подавать подсказки.

Поток
  1. Загрузите рабочий процесс видео
    Запустите рабочий процесс «shorts-v2» со списком сцен: [подсказки сцены].✓ Скопировано
    → Сегменты поставлены в очередь; прогресс за сцену
  2. Сшить и опубликовать
    Опубликуйте финальное видео.✓ Скопировано
    → Путь вывода + публикация метаданных

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

Подводные камни
  • Исчерпание памяти графического процессора на длинных клипах — Уменьшите разрешение или количество кадров на сегмент; партия последовательно

Комбинации

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

comfyui-mcp-server + comfy-pilot

Соедините этот MCP с редактором Claude-Code-in-ComfyUI для полноценной разработки.

Создайте рабочий процесс через comfy-pilot, запустите его через этот MCP-сервер.✓ Скопировано
comfyui-mcp-server + filesystem

Организуйте созданные ресурсы в папках проекта.

После каждого пакета перемещайте выходные данные в ./assets/<project>/ с датированными именами файлов.✓ Скопировано
comfyui-mcp-server + mcp-image

Используйте mcp-образ для одноразового рода Gemini; ComfyUI для ваших локальных конвейеров SD/FLUX

Драфт героя через mcp-образ; доставляйте набор брендов с помощью рабочего процесса ComfyUI.✓ Скопировано

Инструменты

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

ИнструментВходные данныеКогда вызыватьСтоимость
generate_image prompt, settings Стандартное преобразование текста в изображение local compute only
generate_song / generate_video prompt, workflow Генерация аудио/видео с помощью специальных рабочих процессов local compute
regenerate reference job_id, tweaks Повторить предыдущий результат local compute
view_image asset_id Показать актив встроенным 0
get_queue_status / get_job / cancel_job job_id Управление жизненным циклом 0
list_assets / get_asset_metadata filter Просмотрите сгенерированные результаты 0
list_models / get_defaults / set_defaults optional model name Переключите контрольные точки или измените настройки по умолчанию 0
list_workflows / run_workflow name + inputs Запуск сохраненных рабочих процессов 0 to start
publish_asset / get_publish_info asset_id Отметьте последний актив 0

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

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

Квота API
Только локально — привязано к вашему графическому процессору
Токенов на вызов
Текст подсказки небольшой; большие байты ресурсов
Деньги
Бесплатно — ваше электричество и оборудование
Совет
Используйте более низкие шаги/меньшее разрешение для итерации; зарезервируйте полные настройки для кипера.

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

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

Хранение учётных данных: Нет учетных данных для локального ComfyUI. Если вы проксируете его в облаке, добавьте аутентификацию на прокси.
Исходящий трафик: ComfyUI работает локально; трафик сервера по умолчанию 127.0.0.1. Загрузка моделей осуществляется с HuggingFace/CivitAI в зависимости от вашего рабочего процесса.

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

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

Соединение отклонено 127.0.0.1:8188

Сначала запустите ComfyUI; убедитесь, что пользовательский интерфейс загружается в браузере.

Проверить: curl localhost:8188/system_stats
Рабочий процесс завершается сбоем из-за отсутствия пользовательского узла

Откройте ComfyUI Manager и установите необходимые пользовательские узлы, затем повторите попытку.

Проверить: Manager → Install Missing Custom Nodes
Очередь заданий, но никогда не завершается

Проверьте собственную консоль ComfyUI на наличие ошибки CUDA OOM или загрузки модели.

Проверить: Inspect the ComfyUI terminal output

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

ComfyUI MCP Server в сравнении

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

Ещё

Ресурсы

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

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

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