Z-Image Studio MCP
Локальная генерация картинок моделью Z-Image-Turbo: CLI, веб-интерфейс и MCP-сервер с инструментом generate.
- 128 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер запускает тяжелую модель на вашем компьютере и записывает картинки и базу LoRA в пользовательские папки.
- HTTP-сервер слушает порт, поэтому закройте его от внешней сети, если он не нужен.
Установка
- Работает в
Ручная установка
uv tool install git+https://github.com/iconben/z-image-studio.gitПервый вариант из раздела Global installation: команда `zimg` становится доступна из любой папки. Обновление выполняет `uv tool upgrade z-image-studio`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер запускает тяжелую модель на вашем компьютере и записывает картинки и базу LoRA в пользовательские папки.
- HTTP-сервер слушает порт, поэтому закройте его от внешней сети, если он не нужен.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Z-Image Studio запускает модель Z-Image-Turbo на вашем компьютере и отдает ее агентам по MCP. Сервер дает три инструмента: `generate` создает картинку по описанию, `list_models` показывает доступные модели, `list_history` выводит историю генераций. Подключение идет тремя путями. Для локальных агентов подходит stdio-команда `zimg-mcp`, а после `zimg serve` доступны Streamable HTTP по адресу `/mcp` и SSE по `/mcp-sse`. Те же возможности есть в командной строке `zimg` и в веб-интерфейсе с LoRA, где за раз применяются до четырех адаптеров.
Для кого. Дизайнерам и разработчикам, которым нужны картинки от агента без облачного API и платы за каждый кадр.
Подходит, если
- Агент делает иллюстрации для сайта, а запросы к чужому облаку нежелательны.
- Стиль задается LoRA, и нужно подмешать до четырех адаптеров с разной силой.
- Серия картинок должна воспроизводиться по зерну seed.
- Gemini CLI или Cline уже настроены, и к ним нужно подключить локальный генератор картинок.
Не подходит, если
- На машине нет дискретной видеокарты и мало памяти: на процессоре генерация идет медленно.
- Нужна модель вне семейства Z-Image: инструмент заточен под Z-Image-Turbo и ее варианты.
- Результат нужен за секунды на любом ноутбуке: скорость зависит от видеокарты.
Пример запроса к агенту
Сгенерируй баннер 1280 на 720: закат над горным озером, фотореализм, и покажи историю последних запусков.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
ZIMAGE_DISABLE_MCP- Значение 1 отключает конечные точки MCP у веб-сервера.
ZIMAGE_BASE_URL- Базовый адрес для ссылок на готовые файлы.
Ограничения
Нужны Python 3.11 или новее и `uv`. Ускорение есть для NVIDIA CUDA, AMD ROCm на Linux, Intel XPU и Apple Silicon; без совместимой видеокарты генерация падает на процессор. На Windows карты AMD пока работают на процессоре, потому что ROCm есть только для Linux. На Python 3.12 и новее `torch.compile` выключен по умолчанию из-за несовместимости с архитектурой модели. Установщик для Windows просит 8 ГБ памяти и больше, а для полной точности лучше 16 ГБ.
Как отключить. Удалите запись z-image-studio из конфигурации MCP-клиента. На стороне сервера отключите конечные точки флагом `--disable-mcp` или переменной `ZIMAGE_DISABLE_MCP=1`.
Частые вопросы
Как подключить stdio-сервер?
Добавьте в конфигурацию клиента сервер `z-image-studio` с командой `zimg-mcp` и пустыми аргументами. Если клиент не находит команду, укажите полный путь.
Какие транспорты есть кроме stdio?
После `zimg serve` работают Streamable HTTP на `/mcp` и SSE на `/mcp-sse/sse`. Клиентам советуют сначала пробовать HTTP, а SSE оставить запасным вариантом.
Что возвращает generate?
Три элемента: текстовые метаданные (размер, время, модель), изображение для предпросмотра и ссылку на файл результата.
Почему Cline обрывает генерацию?
Cline быстро прерывает долгие вызовы, поэтому в его настройках сервера задайте параметр `timeout`, например 300 секунд.
Есть ли готовый установщик?
Для Windows 10 и 11 есть установщик на странице релизов. Для остальных систем доступны `uv tool install`, `pip install z-image-studio` и образ Docker.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для создания и правки картинок: Gemini, OpenAI и Seedream с автоматической доработкой запроса
MCP-сервер RunAPI: каталог из 160 моделей для изображений, видео, музыки и речи, цены, запуск задач и баланс
Скилл, MCP-сервер и CLI: любой агент вызывает встроенную генерацию картинок Codex, выбрав стиль из нескольких направлений
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
Удаленный MCP-сервер с 40 инструментами: 3D-модель по тексту или фото, риггинг, анимация, ретекстурирование и проверка GLB
MCP-сервер для генерации изображений и видео из агента: несколько моделей, большая библиотека промптов и параллельные задачи
Коротко о README
Проект собирает три интерфейса вокруг одной модели: командную строку, веб-интерфейс и MCP. Каталог для картинок и конфигурация настраиваются через файл и переменные окружения.