mcp-image
mcp-image — MCP-сервер сообщества (автор — shinpr). Генерация и правка изображений с оптимизацией промптов. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- shinpr
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Сохраняет изображения на диск, читает исходные файлы, отправляет промпты выбранной модели; генерация оплачивается по вашим ключам.
Настройка клиентов
{
"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.
OpenScreen
Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.
ffmpeg-skill
Локальные инструменты FFmpeg для видео и аудио.
davinci-resolve-mcp
Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.