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

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

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

Один инструмент:generate_image (охватывает создание + редактирование)
Автоматическое улучшение подсказок (тема · контекст · стиль)
Три уровня качества: быстрое, сбалансированное, качественное
разрешение 4К; соотношение сторон от 1:1 до 21:9
Согласованность символов во всех вызовах
Обучение поиску в Google + мировые знания

Живое демо

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

mcp-image.replay ▶ готово

0/0

Установка

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

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

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-image",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

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

claude mcp add mcp-image -- npx -y mcp-image

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

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

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

Создайте, а затем повторите главное изображение для целевой страницы.

👤 Дизайнеры, основатели, маркетологи ⏱ ~15 min beginner

Когда использовать: Вам нужно свежее изображение героя и вы не хотите манипулировать 5 вкладками.

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

API-ключ Gemini — https://aistudio.google.com/apikey
Выходной каталог — mkdir -p ~/images/mcp

Поток

Создать версию 1

Создайте главное изображение: минимальное рабочее пространство, теплый свет золотого часа, 16:9, уровень качества, 2048 пикселей.✓ Скопировано

→ Изображение сохранено в IMAGE_OUTPUT_DIR, а расширенное приглашение возвращается обратно.
Редактировать на месте

Отредактируйте его — добавьте тонкую линию деревьев на горизонте, все остальное оставьте.✓ Скопировано

→ Вариант сохранен; состав сохранен
Попробуйте вариант

Та же сцена, но в более холодных тонах, сохраняйте объект идентичным.✓ Скопировано

→ Постоянство характера сохраняется; цвет изменился

Итог: Готовый образ героя за считанные минуты, а не платный проезд туда и обратно через Midjourney.

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

Чрезмерное приглашение оптимизатора — Позвольте усилителю «Субъект-Контекст-Стиль» выполнить свою работу; хватит переопределять 5 строк прилагательных

Сочетать с: filesystem

Создайте набор иллюстраций, соответствующих бренду.

👤 Одиночные основатели и дизайнеры без библиотеки брендовых активов ⏱ ~45 min intermediate

Когда использовать: Вам понадобится 6–12 иллюстраций, которые будут выглядеть гармонично.

Поток

Определить таблицу стилей

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

→ Исходное изображение отражает стиль
Создавайте варианты

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

→ 6 изображений в едином стиле + персонажи

Итог: Сплоченный набор иллюстраций без найма иллюстратора на один день.

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

Дрейф между изображениями — Всегда ссылайтесь на исходное изображение и используйте «сохранять стиль от начального значения».

Редактируйте фотографии продуктов на естественном языке

👤 Операторы электронной коммерции, небольшие бренды ⏱ ~20 min beginner

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

Поток

Загрузите/дайте ссылку на фотографию

Используйте product.jpg в качестве основы. Уберите загроможденный фон; держать тень; студийное освещение.✓ Скопировано

→ Чистый продукт, снятый с естественной тенью
Добавить контекст

Тот же продукт на теплой мраморной поверхности сверху вниз.✓ Скопировано

→ Согласованный продукт с новой средой

Итог: Готовые изображения для каталога за считанные минуты.

Сочетать с: filesystem

Комбинации

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

mcp-image + filesystem

Создание, составление списка, тегирование и организация библиотеки изображений.

Сгенерируйте сегодняшний набор в ~/images/mcp/2026-04-21/; затем перечислите и переименуйте с помощью альтернативного текста.✓ Скопировано

mcp-image + magic-ui-mcp

Перетащите созданные изображения героев на лендинг Magic UI.

Создайте изображение героя, а затем подключите его к компоненту героя Magic UI.✓ Скопировано

mcp-image + comfyui-mcp-server

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

Быстрые варианты через mcp-образ; производственный процесс через ComfyUI.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать	Стоимость
generate_image	prompt: str, tier?: fast\|balanced\|quality, aspect?: '1:1'\|'16:9'\|..., base_image?: path, size?: '1K'\|'2K'\|'4K'	Создайте новое изображение или отредактируйте существующее на естественном языке.	1 Gemini image call

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

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

Квота API: Связано с квотой на создание изображений вашего плана Gemini API.
Токенов на вызов: Незначительно для текста; байты изображения доминируют
Деньги: Оплата за изображение через Gemini API; бесплатный уровень доступен для разработки
Совет: Используйте tier=fast для итерации и tier=quality только для финального хранителя.

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

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

Хранение учётных данных: GEMINI_API_KEY только в env — никогда не фиксируйте. Если произошла утечка информации, удалите ее из Google AI Studio.

Исходящий трафик: Подсказки и дополнительные базовые изображения передаются в API Gemini Google. Сгенерированные байты возвращаются и сохраняются локально.

Политика Google применяется к созданным изображениям. Не создавайте контент, которым вы не имеете права делиться.
Базовые изображения, которые вы передаете на редактирование, загружаются в Gemini — обращайтесь с ними так, как если бы вы разместили их в Интернете.

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

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

401/ключ API недействителен

Убедитесь, что GEMINI_API_KEY — это необработанный ключ API от AI Studio (не токен OAuth), и для него включено создание изображений.

Проверить: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY

Выходы сохранены, но пусты

Возможно, IMAGE_OUTPUT_DIR недоступен для записи или отсутствует. Создайте его и повторите попытку.

Проверить: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe

Характер меняется между поколениями

Всегда передавайте одно и то же base_image и включайте в подсказку «сохранять тему идентичной».

Проверить: Diff two generations visually

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

MCP Image в сравнении

Альтернатива	Когда использовать	Компромисс
everart	У вас есть модели Everart, прошедшие обучение стилю.	Другой провайдер, другой стиль покрытия
comfyui-mcp-server	Вам нужны собственные рабочие процессы SD/FLUX и полный контроль над конвейером.	Гораздо более тяжелая установка
higgsfield-ai-prompt-skill	Вам нужна оперативная инженерная помощь для другого поставщика	Только подсказки — никаких выводов

Ещё

Ресурсы

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

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

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