GIMP MCP: правка картинок в GIMP из Claude Code, Codex и Cursor

gimp-mcp/gimp-mcp· Проверено 12.11.2026· 290на GitHub

Даёт агенту править картинки в открытом GIMP: тон и цвет, выделения, слои, текст, фильтры и экспорт. Между шагами агент снимает превью и сам проверяет, что получилось.

2 реализации:

Для GIMP 3.2: плагин и сервер ставятся одним пакетом с PyPI через uvx, 79 инструментов и живое превью get_state_snapshot.

Как подключить

Что сделать до подключения

GIMP 3.2 или новее и uv

Один раз запустить и закрыть GIMP, затем выполнить uvx gimp-mcp-plugin@latest install-plugin и перезапустить GIMP

Открыть любое изображение и выбрать Tools → MCP → Start MCP Server: сервер слушает localhost:9877; автозапуск включается в Tools → MCP → MCP Server Settings

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio gimp \
  -- uvx gimp-mcp-plugin@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gimp]
command = "uvx"
args = ["gimp-mcp-plugin@latest"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gimp": {
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gimp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gimp": {
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gimp": {
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gimp": {
        "type": "local",
        "command": ["uvx", "gimp-mcp-plugin@latest"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "gimp": {
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gimp": {
      "command": "uvx",
      "args": ["gimp-mcp-plugin@latest"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_state_snapshotпоказывает агенту превью картинки

open_imageоткрывает файл

export_imageвыгружает в PNG, JPEG, BMP, TIFF

adjust_brightness_contrastменяет яркость и контраст

adjust_hue_saturationменяет оттенок и насыщенность

adjust_curvesправит кривые по каналам

scale_imageменяет размер изображения

crop_to_rectобрезает по прямоугольнику

select_by_colorвыделяет по цвету

invert_selectionинвертирует выделение

create_layerсоздаёт слой

set_layer_propertiesменяет прозрачность и режим слоя

add_textдобавляет текстовый слой

fill_selectionзаливает выделение

gradient_fillзаливает градиентом

apply_drop_shadowдобавляет тень

export_icon_sizesвыгружает набор иконок Android или iOS

batch_exportвыгружает все открытые картинки

undoотменяет действия

call_apiвыполняет код Python-Fu в GIMP

Показано 20 из 79.

Для GIMP 2.10 через встроенный сервер Script-Fu, в GIMP ничего не ставится: доступна вся база процедур, рецепты, пакетная обработка папок и GIF.

Как подключить

Что сделать до подключения

GIMP 2.10 (проверено на 2.10.30 и новее), команда gimp в PATH

Python 3.10 или новее: склонировать репозиторий и выполнить pip install -r requirements.txt

Запустить сервер Script-Fu: ./start-gimp-server.sh без окна или с --gui для открытого GIMP, либо Filters → Script-Fu → Start Server; порт 10008

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio gimp-mcp \
  -- python3 '<путь к gimp-mcp>/server.py'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gimp-mcp]
command = "python3"
args = ["<путь к gimp-mcp>/server.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gimp-mcp": {
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gimp-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gimp-mcp": {
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gimp-mcp": {
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gimp-mcp": {
        "type": "local",
        "command": ["python3", "<путь к gimp-mcp>/server.py"]
      }
    }
  }
}

{
  "mcpServers": {
    "gimp-mcp": {
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gimp-mcp": {
      "command": "python3",
      "args": ["<путь к gimp-mcp>/server.py"]
    }
  }
}

Инструменты сервера

lookпоказывает агенту текущую картинку

inspectмеряет яркость и контраст области

describeсообщает размер, режим и слои

gimp_evalвыполняет выражение Script-Fu

pdb_queryищет процедуры в базе GIMP

pdb_helpпоказывает аргументы процедуры

load_imageоткрывает файл

export_imageвыгружает картинку

scale_imageменяет размер

brightness_contrastменяет яркость и контраст

add_textдобавляет текст с привязкой

arc_textпишет текст по дуге

color_to_alphaделает фон прозрачным

trim_to_contentобрезает по непрозрачному

placeставит слой по краю или центру

apply_recipeприменяет сохранённый рецепт

journalзаписывает действия в рецепт

batch_watermarkставит водяной знак на папку

frames_to_gifсобирает GIF из слоёв

checkpointсохраняет точку отката

Показано 20 из 89.

Что попросить агента

«Убери фон с этого изображения и повторяй, пока не останется только персонаж»GIMP MCP выделит фон через select_by_color, удалит его и будет проверять результат get_state_snapshot, пока фон не исчезнет

«Открой <файл>.png, убери фон, проверь, что он чистый, и выгрузи итог в PNG»GIMP MCP вызовет open_image, затем правки с проверкой get_state_snapshot и export_image

«Подними контраст, сдвинь оттенок на 15 градусов теплее и покажи лицо крупно до и после»GIMP MCP вызовет adjust_brightness_contrast и adjust_hue_saturation, затем get_state_snapshot с областью лица

«Добавь сверху жирный белый заголовок с лёгкой тенью и выгрузи для сайта»GIMP MCP вызовет add_text, apply_drop_shadow и export_web_optimized

«Открой ~/pic.jpg, уменьши до 800 px по ширине, подними контраст, посмотри и выгрузи PNG»constant-itis/gimp-mcp вызовет load_image, scale_image, brightness_contrast, look и export_image

Для каких задач

Убрать фон и повторять проверку по превью, пока фон не исчезнет

Поднять контраст, сдвинуть оттенок и показать до и после крупным планом

Добавить заголовок с тенью и выгрузить картинку для сайта

Выгрузить набор иконок для Android или iOS из одного изображения

Обработать папку фото: уменьшить, сменить формат, поставить водяной знак

Собрать анимированный GIF из слоёв

Ограничения

Оба сервера работают, только пока открыт GIMP с запущенным сервером плагина или Script-Fu

GIMP MCP рассчитан на GIMP 3.2 и новее; constant-itis/gimp-mcp написан под GIMP 2.10 и на Windows не проверялся

call_api и gimp_eval выполняют любой код внутри GIMP; песочница для недоверенных команд у GIMP MCP только в планах

У constant-itis/gimp-mcp 6 звёзд и последнее обновление 31.07.2026; в GIMP 2.10 нет отмены через API, откатиться можно только к checkpoint

Если не работает

Could not connect to GIMP

GIMP должен быть открыт с изображением и запущенным сервером: Tools → MCP → Start MCP Server. Если меняли порт, задайте тот же в GIMP_MCP_PORT и проверьте, что фаервол не закрыл 9877.

GIMP did not reply within 300 s

Команда шла дольше, чем ждёт сервер: увеличьте GIMP_MCP_TIMEOUT в секундах. GIMP может ещё выполнять команду, проверьте картинку перед повтором.

Плагина нет в меню GIMP

Ищите в Tools → MCP. После обновления GIMP, например с 3.0 до 3.2, папка плагинов меняется: снова выполните uvx gimp-mcp-plugin@latest install-plugin, папку покажет --dry-run.

check_server пишет, что версии плагина и сервера не совпадают

Перезапустите клиент, выполните uvx gimp-mcp-plugin@latest install-plugin и перезапустите GIMP.

constant-itis/gimp-mcp: текст не рисуется, слой пустой

GIMP запущен с флагом -f или --no-fonts. Запускайте его через start-gimp-server.sh без этого флага и проверьте имя шрифта через list_fonts.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
GIMP MCP	gimp-mcp	290	локально	не нужен	79	12 ноября 2026
gimp-mcp для GIMP 2.10	constant-itis	6	локально	не нужен	89	31 июля 2026

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

Какой из двух серверов выбрать?

Смотрите на версию GIMP. Для GIMP 3.2 и новее берите GIMP MCP: он ставится одной командой uvx. Для GIMP 2.10 подходит constant-itis/gimp-mcp: он работает через встроенный сервер Script-Fu и ничего в GIMP не ставит.

Как агент видит, что получилось?

В GIMP MCP инструмент get_state_snapshot возвращает PNG текущего состояния без сохранения на диск и умеет приближать область, например лицо. В constant-itis/gimp-mcp ту же роль играет look, а inspect меряет яркость области под текст.

Как обновить GIMP MCP?

Перезапустите клиент: с @latest uvx возьмёт новую версию сервера. Затем выполните uvx gimp-mcp-plugin@latest install-plugin и перезапустите GIMP. Версии плагина и сервера должны совпадать, check_server сообщит о расхождении.

Можно уменьшить число инструментов?

У constant-itis/gimp-mcp инструменты разбиты на пакеты: задайте GIMP_MCP_PACKS=core,text,select, и останется около 24 инструментов. Это удобно для локальных моделей с маленьким контекстом.

Как подключить GIMP MCP к Claude Code?

Поставьте плагин командой uvx gimp-mcp-plugin@latest install-plugin, запустите сервер в GIMP и выполните claude mcp add gimp-mcp -- uvx gimp-mcp-plugin@latest. Для GIMP 2.10: claude mcp add gimp -s user -- python3 <путь>/server.py.

Где скачать GIMP MCP?

Сервер и плагин GIMP MCP лежат одним пакетом gimp-mcp-plugin на PyPI, клонировать репозиторий не нужно. Исходники — в gimp-mcp/gimp-mcp на GitHub.

GIMP MCP работает с GIMP 2.10?

GIMP MCP рассчитан на GIMP 3.2 и новее. Для GIMP 2.10 есть constant-itis/gimp-mcp: он подключается к встроенному серверу Script-Fu на порту 10008.

Работает ли сервер из России?

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

GIMP MCP: правка картинок в GIMP из Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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