mcp-image — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер создаёт и редактирует изображения через Gemini, OpenAI или BytePlus Seedream, уточняя короткий запрос перед генерацией.
claude mcp add --env IMAGE_PROVIDER=<IMAGE_PROVIDER> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env ARK_API_KEY=<ARK_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> --transport stdio mcp-image -- npx -y mcp-imageЧто делает mcp-image
mcp-image принимает описание новой картинки или путь к существующему файлу для правки. Перед отправкой в модель сервер делает запрос подробнее: сохраняет исходную задумку и добавляет визуальные детали, например композицию, свет и ракурс. Готовый файл записывается в заданную папку и возвращается ассистенту как MCP-ресурс.
Поддерживаются Gemini, OpenAI и BytePlus Seedream. Для Gemini доступны размеры 1K, 2K и 4K, а для OpenAI и Seedream результат может быть в PNG или JPEG. Качество задаётся через IMAGE_QUALITY: fast, balanced или quality; исходное значение — fast. Промпт можно отправить без доработки, установив SKIP_PROMPT_ENHANCEMENT=true.
Для запуска нужен Node.js версии 22 или новее, MCP-совместимый клиент и ключ выбранного провайдера. Без такого ключа сервер не создаст и не изменит изображение. В конфигурации стоит указывать абсолютный IMAGE_OUTPUT_DIR, иначе путь зависит от рабочей папки клиента.
Какие задачи решает
- создать изображение по текстовому описанию
- изменить картинку по абсолютному пути
- уточнить короткий промпт перед отправкой в модель
- сохранить результат в заданную папку
- переключить провайдера генерации изображений
Примеры запросов агенту
- Создай предметное фото керамической кружки на деревянном столе и сохрани результат в настроенную папку.
- Отредактируй
/path/to/image.jpg, чтобы человек смотрел вправо. - Сгенерируй кинематографичный пустынный пейзаж с соотношением сторон 21:9.
Как установить mcp-image
Командой платформы
claude mcp add --env IMAGE_PROVIDER=<IMAGE_PROVIDER> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env ARK_API_KEY=<ARK_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> --transport stdio mcp-image -- npx -y mcp-imageВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add mcp-image --env IMAGE_PROVIDER=<IMAGE_PROVIDER> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env ARK_API_KEY=<ARK_API_KEY> --env IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> -- npx -y mcp-imageВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-image": {
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"IMAGE_PROVIDER": "<IMAGE_PROVIDER>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ARK_API_KEY": "<ARK_API_KEY>",
"IMAGE_OUTPUT_DIR": "<IMAGE_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-image": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"IMAGE_PROVIDER": "<IMAGE_PROVIDER>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ARK_API_KEY": "<ARK_API_KEY>",
"IMAGE_OUTPUT_DIR": "<IMAGE_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e IMAGE_PROVIDER=<IMAGE_PROVIDER> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e ARK_API_KEY=<ARK_API_KEY> -e IMAGE_OUTPUT_DIR=<IMAGE_OUTPUT_DIR> mcp-image npx -y mcp-imageВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-image
Как установить mcp-image в Claude Code?
Выполните команду `claude mcp add mcp-image -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e ARK_API_KEY=<ARK_API_KEY> -- npx -y mcp-image`.
Что делает mcp-image?
Сервер создаёт изображения и редактирует существующие файлы через MCP. Он уточняет текстовый запрос перед передачей провайдеру, а результат сохраняет на диск и возвращает ассистенту.
Какие провайдеры поддерживает mcp-image?
Доступны Gemini, OpenAI и BytePlus Seedream. Для каждого провайдера нужен соответствующий ключ и настройка переменной выбора провайдера.
