mcp-image

mcp-image — MCP-сервер сообщества (автор — shinpr). Генерация и правка изображений с оптимизацией промптов. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
shinpr
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Сохраняет изображения на диск, читает исходные файлы, отправляет промпты выбранной модели; генерация оплачивается по вашим ключам.

Настройка клиентов

codex
{
    "code": "[mcp_servers.mcp-image]\ncommand = \"npx\"\nargs = [\"-y\", \"mcp-image\"]\n\n[mcp_servers.mcp-image.env]\nGEMINI_API_KEY = \"your_gemini_api_key_here\"\nIMAGE_OUTPUT_DIR = \"/absolute/path/to/images\"",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Нужен ключ Gemini, OpenAI или Seedream",
    "verified": "docs"
}

Что умеет

MCP Image Generator (mcp-image) создаёт и редактирует изображения из Codex, Cursor, Claude Code и любого другого MCP-клиента. Вы говорите, какое изображение нужно или что изменить в существующем, и для чего оно. Сервер дописывает к запросу визуальную режиссуру и отправляет его в одну из моделей: Gemini (по умолчанию), OpenAI или BytePlus Seedream. Готовый файл сохраняется на диск и возвращается ассистенту как MCP-ресурс.

Главная особенность — улучшение промпта. Короткий запрос переписывается в подробный: сервер сохраняет то, что вы попросили, и добавляет то, что нужно изображению для его цели, — например, свет и ракурс для фотографии или композицию для постера. Текст, который должен быть на картинке, остаётся в вашей формулировке. Улучшение отключается переменной SKIP_PROMPT_ENHANCEMENT=true.

Всё делает один инструмент generate_image. Его параметры:

  • prompt — описание изображения или инструкция по правке;
  • inputImagePaths — абсолютные пути к исходным изображениям для редактирования (PNG, JPEG или WebP до 10 МиБ);
  • quality — пресет fast, balanced или quality;
  • provider, aspectRatio (от 1:1 до 21:9 и 8:1), imageSize (1K, 2K или 4K в зависимости от модели), fileName;
  • maintainCharacterConsistency — сохранять облик персонажа между изображениями;
  • useWorldKnowledge и useGoogleSearch — контекст о реальных местах и людях, поиск Google только с Gemini;
  • purpose и category — назначение и тип изображения (фото, иллюстрация, интерфейс, диаграмма, текстура и другие).

Кому подойдёт

  • Разработчикам, которым нужны картинки для сайтов и приложений прямо из редактора кода.
  • Авторам контента: фото для рецептов, обложки, посты для соцсетей.
  • Создателям игр и комиксов, которым важен единый облик персонажа.

Похожие серверы — в категории медиа и творчество.

Установка

Нужны Node.js 22 или новее и ключ API одной из моделей: GEMINI_API_KEY для Gemini; IMAGE_PROVIDER=openai и OPENAI_API_KEY для OpenAI (может потребоваться верификация организации); IMAGE_PROVIDER=seedream и ARK_API_KEY для Seedream (без 4K). Можно задать ключи нескольких моделей и переключаться в каждом запросе.

Папку для готовых файлов задаёт IMAGE_OUTPUT_DIR. Указывайте абсолютный путь: рабочий каталог сервера зависит от клиента, и без настройки файлы окажутся в ./output относительно него. Пресет качества по умолчанию задаёт IMAGE_QUALITY; более высокие пресеты работают дольше и могут стоить дороже. После изменения конфигурации перезапустите клиент.

Подключение к клиентам

Конфиги и команда приведены дословно из README. Подробнее — в инструкции как подключить MCP.

[mcp_servers.mcp-image]
command = "npx"
args = ["-y", "mcp-image"]

[mcp_servers.mcp-image.env]
GEMINI_API_KEY = "your_gemini_api_key_here"
IMAGE_OUTPUT_DIR = "/absolute/path/to/images"

Для Codex конфиг добавляют в ~/.codex/config.toml, для Cursor — в ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json проекта. В Claude Code добавьте --scope user после mcp-image, чтобы сервер был доступен во всех проектах.

Проверка

Попросите ассистента сгенерировать фото керамической кружки на деревянном столе — файл появится в папке IMAGE_OUTPUT_DIR.

Примеры задач

Сгенерируй фото запечённой курицы для сайта с рецептами — частично нарезанной, чтобы было видно, какая она сочная.
Отредактируй /path/to/image.jpg так, чтобы человек смотрел вправо.

Риски

  • Запись файлов. Сервер сохраняет изображения в указанную папку; задайте отдельный абсолютный путь.
  • Чтение файлов. Для редактирования сервер читает изображения по переданным путям.
  • Передача данных. Промпты и исходные изображения отправляются выбранной модели — в Google, OpenAI или BytePlus.
  • Расходы. Генерация оплачивается по вашим ключам API; пресет quality может стоить дороже.
  • Ключи. Никогда не коммитьте ключи API в систему контроля версий.

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

Какую модель выбрать?

Gemini используется по умолчанию и требует меньше всего настройки; только он поддерживает поиск Google.

Можно ли отключить переписывание промпта?

Да, задайте SKIP_PROMPT_ENHANCEMENT=true.

Куда сохраняются картинки?

В папку IMAGE_OUTPUT_DIR, а без неё — в ./output относительно рабочего каталога сервера.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники