ComfyUI MCP Server
Легкий MCP-сервер на Python: агент генерирует и по шагам дорабатывает картинки, звук и видео в локальном ComfyUI
- 411 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент запускает задания на вашем ComfyUI и загружает вашу видеокарту
- `publish_asset` пишет и сжимает файлы в каталоге веб-проекта, а сервер слушает локальный адрес без авторизации
Установка
- Работает в
Ручная установка
git clone https://github.com/joenorton/comfyui-mcp-server.git && cd comfyui-mcp-server && pip install -r requirements.txtНужен запущенный ComfyUI, например python main.py --port 8188 в его папке.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент запускает задания на вашем ComfyUI и загружает вашу видеокарту
- `publish_asset` пишет и сжимает файлы в каталоге веб-проекта, а сервер слушает локальный адрес без авторизации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает MCP-клиент с вашим локальным ComfyUI. Агент вызывает `generate_image` с текстом запроса и получает картинку, а остальные параметры берутся из значений по умолчанию: ширина, высота, число шагов, модель. Для звука есть `generate_song`, которому нужны теги и текст песни. Главная идея версии — доработка результата. Каждый файл получает собственный идентификатор, и `regenerate` повторяет генерацию с измененными параметрами, не требуя писать запрос заново. `view_image` показывает готовую картинку самому агенту, чтобы тот оценил ее и поправил запрос. За долгими задачами агент следит через `get_queue_status` и `get_job`, а лишнюю останавливает `cancel_job`. Воркфлоу ComfyUI кладутся в папку workflows как JSON-файлы и становятся инструментами сами. Метки PARAM_PROMPT, PARAM_INT_STEPS и PARAM_FLOAT_CFG превращаются в параметры инструмента. Готовую картинку `publish_asset` копирует в каталог веб-проекта и сжимает до заданного размера, по умолчанию 600 КБ.
Для кого. Для тех, у кого уже работает ComfyUI и кто хочет, чтобы Cursor, Claude Code или n8n сами генерировали картинки для сайта или проекта.
Подходит, если
- Нужно попросить агента сгенерировать главное изображение для сайта и сразу положить его в `public/gen` под нужным именем
- Результат почти подходит, и нужна доработка с другим числом шагов или моделью без пересоздания запроса
- У вас есть собственный воркфлоу ComfyUI, и его нужно открыть агенту как инструмент с параметрами
- Нужно создать трек из тегов и текста через воркфлоу `generate_song` и дождаться готовности по `get_job`
- Нужна библиотека картинок проекта с манифестом: `publish_asset` обновляет его по ключу `manifest_key`
Не подходит, если
- ComfyUI не запущен локально: сервер только передает ему задания и сам ничего не генерирует
- Нужна облачная генерация без своей видеокарты: проект рассчитан на локальный экземпляр ComfyUI
- Сервер нужно открыть в сеть: он слушает локальный адрес без авторизации, и публиковать его без обратного прокси нельзя
- Идентификаторы файлов должны пережить перезапуск: они действуют только в текущей сессии сервера
Пример запроса к агенту
Сгенерируй главное изображение для сайта кофейни, посмотри результат, сделай еще вариант посветлее и опубликуй лучший как hero.webp.MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
COMFY_MCP_DEFAULT_*- Значения по умолчанию для генерации, например размера и числа шагов; имя заканчивается названием параметра
Ограничения
Нужны запущенный ComfyUI (по умолчанию на порту 8188), Python и пакеты из requirements.txt: requests, mcp и Pillow. Модели должны лежать в каталоге models/checkpoints внутри ComfyUI.
Сервер слушает адрес 127.0.0.1:9000 без авторизации, поэтому его нельзя выставлять наружу без обратного прокси или собственной защиты. Звук собирается готовым воркфлоу, а видео и другие сценарии требуют своих файлов в папке workflows.
Каталог публикации определяется автоматически среди public/gen, static/gen и assets/gen. Если вывод ComfyUI найти не удалось, путь задается один раз инструментом `set_comfyui_output_root`. Для Comfy Desktop и нестандартных установок это рекомендуемый шаг.
Как отключить. Остановите процесс `python server.py` и удалите запись comfyui-mcp-server из файла `.mcp.json` или настроек MCP в вашем клиенте. Постоянные значения по умолчанию лежат в `~/.config/comfy-mcp/config.json`, этот файл можно удалить вручную.
Частые вопросы
Как подключить ComfyUI к Cursor или Claude Code через MCP?
Запустите ComfyUI, затем `python server.py` из папки проекта. В файле `.mcp.json` добавьте сервер с типом streamable-http и адресом http://127.0.0.1:9000/mcp, после чего перезапустите клиент. Если автоопределение не сработало, замените тип на http.
Как проверить сервер без MCP-клиента?
Запустите `python test_client.py`, при желании с ключом `-p` и своим запросом. Клиент подключается к серверу, выводит список инструментов и значения по умолчанию, генерирует картинку и печатает сведения о результате.
Как доработать картинку, не переписывая запрос?
Инструмент `regenerate` принимает идентификатор файла `asset_id` и новые значения параметров. Сведения о происхождении файла, включая историю воркфлоу, возвращает `get_asset_metadata`.
Как добавить свой воркфлоу ComfyUI?
Положите JSON воркфлоу в папку workflows и поставьте в нужные места метки PARAM_PROMPT, PARAM_INT_STEPS или PARAM_FLOAT_CFG. Имя инструмента берется из имени файла, например my_workflow.json дает инструмент my_workflow.
Где задаются значения по умолчанию для размера и числа шагов?
Порядок такой: значения в вызове, затем заданные через `set_defaults`, затем файл `~/.config/comfy-mcp/config.json`, затем переменные COMFY_MCP_DEFAULT_, затем встроенные. Через `set_defaults` значения можно сохранить между запусками.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Comfy Org: агент запускает воркфлоу в вашем локальном ComfyUI и забирает готовые изображения
MCP-сервер для генерации изображений и видео из агента: несколько моделей, большая библиотека промптов и параллельные задачи
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
Удаленный MCP-сервер Recraft: агент рисует растровые и векторные изображения, редактирует область, убирает фон и увеличивает разрешение
Размещенный MCP-сервер Magic Hour: агент генерирует и редактирует видео, изображения и аудио через API сервиса
ClipForge MCP
ClipForge
ClipForge MCP собирает вертикальное видео из темы или ссылки на товар: сток, озвучка Edge TTS и субтитры без ключей, сборка через FFmpeg
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ComfyUI MCP Server (эта запись) | нет | не нужна | 411 | |
| Comfy MCP | да | не нужна | 311 | официальный MCP-сервер Comfy Org с запуском воркфлоу, а этот сервер с итерациями, идентификаторами файлов и публикацией в веб-проект |
| MeiGen AI Design MCP | да | API-ключ | 1 793 | генерация через несколько облачных моделей, а этот сервер работает только с вашим локальным ComfyUI |
Из блога
Коротко о README
Описание ведет от быстрого запуска за две-три минуты к списку инструментов и справке по настройкам. Отдельные заметки объясняют, чем нынешняя версия с потоковым HTTP отличается от прежней на WebSocket. Подробная справка по параметрам и описание архитектуры вынесены в папку docs.