MCP Image Generator

MCP-сервер для создания и правки картинок: Gemini, OpenAI и Seedream с автоматической доработкой запроса

  • 190 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Каждый запрос уходит провайдеру и тарифицируется, ключи API платные
  • Файлы для правки читаются с диска по абсолютному пути и отправляются в облако
Все причины и проверки

shinpr/mcp-image

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-image-generator

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Каждый запрос уходит провайдеру и тарифицируется, ключи API платные
  • Файлы для правки читаются с диска по абсолютному пути и отправляются в облако

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

mcp-image принимает короткий запрос на картинку, сам превращает его в подробный промпт и отправляет выбранной модели: Gemini (по умолчанию), OpenAI GPT Image или BytePlus Seedream. Результат сохраняется на диск и возвращается ассистенту как ресурс MCP. Доработка запроса сохраняет сказанное и добавляет то, что нужно для цели: для фото свет и ракурс, для постера композицию. Текст, который должен попасть на картинку, остается как вы написали, на вашем языке. Отключить доработку можно переменной `SKIP_PROMPT_ENHANCEMENT=true`. Кроме создания есть правка готового изображения по абсолютному пути, выбор качества пресетами `fast`, `balanced` и `quality`, соотношения сторон и размера 1K, 2K и 4K (у Seedream до 2K). Google Search grounding доступен только у Gemini. Выходной каталог задает `IMAGE_OUTPUT_DIR`. Провайдер выбирается переменной `IMAGE_PROVIDER` вместе с ключом.

Для кого. Разработчикам и дизайнерам, которым нужны иллюстрации, продуктовые фото и правки изображений прямо из Codex, Cursor или Claude Code.

Подходит, если

  • Для рецепта нужна фотография блюда, и короткую просьбу система разворачивает в подробный промпт
  • Нужен постер с текстом на русском, который остается дословно
  • Готовую картинку правят: повернуть человека лицом вправо, сохранив остальное
  • Персонаж должен выглядеть так же на следующем кадре, и запрос ссылается на предыдущую картинку
  • Модель переключают между Gemini, OpenAI и Seedream без смены способа просить

Не подходит, если

  • Нужна точная генерация без рассуждений модели над запросом: доработку отключают переменной
  • Нет ключа ни у одного из трех провайдеров: сервер сам изображения не рисует
  • Нужен локальный запуск без отправки запросов в облако: все три модели работают через API

Пример запроса к агенту

Сгенерируй продуктовое фото керамической кружки на деревянном столе для карточки в магазине

MCP

Транспорт
stdio
Авторизация
ключ необязателен

Переменные окружения

GEMINI_API_KEY секрет
Ключ Gemini, провайдер по умолчанию.
OPENAI_API_KEY секрет
Ключ OpenAI при `IMAGE_PROVIDER=openai`.
ARK_API_KEY секрет
Ключ BytePlus ModelArk для Seedream.
IMAGE_OUTPUT_DIR
Каталог для готовых изображений.

Ограничения

Нужны Node.js 22 или новее и ключ одного провайдера: `GEMINI_API_KEY`, `OPENAI_API_KEY` или `ARK_API_KEY` для Seedream. Каждый запрос уходит провайдеру и тарифицируется по его правилам, высокие пресеты качества работают дольше и стоят дороже. OpenAI может потребовать подтверждения организации перед генерацией изображений. Формат вывода PNG или JPEG у OpenAI и Seedream, у Gemini автоматический. В конфигурации MCP задайте абсолютный `IMAGE_OUTPUT_DIR`: рабочий каталог сервера зависит от клиента, иначе картинки попадут в `./output`.

Как отключить. Удалите сервер в клиенте (`claude mcp remove mcp-image`) и отзовите ключ провайдера в его кабинете; созданные картинки останутся в `IMAGE_OUTPUT_DIR`.

Частые вопросы

Как подключить mcp-image к Claude Code?

Выполните `claude mcp add mcp-image --env GEMINI_API_KEY=your-api-key --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-image`. Добавьте `--scope user`, чтобы сервер работал во всех проектах.

Как выбрать провайдера?

Задайте `IMAGE_PROVIDER` значением `gemini`, `openai` или `seedream` и ключ соответствующего провайдера. По умолчанию работает Gemini.

Что делает доработка запроса?

Короткий запрос превращается в подробный: добавляются свет, ракурс или композиция под цель картинки. Текст для изображения остается как написан. Отключается `SKIP_PROMPT_ENHANCEMENT=true`.

Можно ли править готовое изображение?

Да, передайте абсолютный путь к файлу и опишите правку, например «повернуть человека лицом вправо». Результат сохраняется в `IMAGE_OUTPUT_DIR`.

Как управлять качеством?

Переменной `IMAGE_QUALITY` со значениями `fast`, `balanced` или `quality`, либо параметром `quality` в запросе. Выше качество, дольше и дороже.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

MCP-сервер для генерации изображений и видео из агента: несколько моделей, большая библиотека промптов и параллельные задачи

MCP-серверРасширенный доступ1,8 тыс.Звезды репозитория

MCP-сервер генерации и правки картинок моделями Gemini: сам выбирает модель под запрос, рисует до 4K в нужном формате кадра

MCP-серверРасширенный доступ405Звезды репозитория
Официальный

MCP-сервер RunAPI: каталог из 160 моделей для изображений, видео, музыки и речи, цены, запуск задач и баланс

MCP-серверРасширенный доступ56Звезды репозитория

Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото

MCP-серверРасширенный доступ339Звезды репозитория

Плагин media-pipeline рисует картинки через Gemini или OpenAI gpt-image-2: скилл, CLI и MCP-сервер ставятся одним шагом.

ПлагинРасширенный доступ83Звезды репозитория
Официальный

Удаленный MCP-сервер Recraft: агент рисует растровые и векторные изображения, редактирует область, убирает фон и увеличивает разрешение

MCP-серверРасширенный доступ

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP Image Generator (эта карточка)нетключ необязателен190
GigaChat Image MCP: картинки Kandinsky из Claude без VPNнетAPI-ключ0генерация через GigaChat; здесь Gemini, OpenAI и Seedream с доработкой запроса
ImageSorcery MCPнетне нужна339обработка и распознавание изображений локальными моделями; здесь создание и правка картинок облачными моделями

Коротко о README

README показывает пример доработки запроса со сравнением, таблицу провайдеров и быстрый старт для Codex, Cursor и Claude Code. Затем идут примеры правки, управления результатом, переменные окружения и справочник инструмента.

Бейдж для README

Сообщить о проблеме