ImageStep — MCP-сервер для Claude Code: генерация и обработка картинок
MCP-сервер для работы с изображениями: генерация, трансформации и пресеты. Картинки не попадают в контекст — на выходе только id, пути и ссылки.
claude mcp add mcp -e IMAGESTEP_API_KEY=<IMAGESTEP_API_KEY> -- npx -y @imagestep/mcpЧто делает ImageStep
ImageStep даёт агенту инструменты для картинок: generate создаёт изображения по промпту, transform выполняет одну операцию, run_preset прогоняет сохранённый пресет из нескольких шагов, job_status показывает прогресс задания, search_assets ищет ассеты, save_preset сохраняет цепочку операций под именем и версией. Пресет с subjects удерживает одного персонажа или товар одинаковым по всей партии, а slug@version фиксирует конкретную версию.
Байты изображений в контекст не возвращаются: инструмент отвечает идентификатором ассета, путём к временному файлу или ссылкой. У transform два режима, и выбирает их не агент, а входные данные. Синхронный режим включается, когда на входе ровно один локальный файл или один URL, операция детерминированная и передан wait: true — тогда ничего не сохраняется в аккаунте. Всё остальное уходит в задание с прогрессом и отменой. Локальный сервер отдаёт path, хостинг по адресу https://mcp.imagestep.dev/mcp — подписанную ссылку с expiresInSeconds.
Для работы нужен ключ IMAGESTEP_API_KEY. У платных инструментов есть dry_run: он показывает точную цену и ничего не создаёт, поэтому ошибку в параметре отклонят до списания. Повторный вызов с тем же idempotency_key и теми же аргументами вернёт результат первого вызова, а не создаст второе задание.
Какие задачи решает
- сгенерировать картинку по промпту и получить ссылку на неё
- прогнать партию изображений через один пресет с сохранением персонажа
- убрать фон или увеличить разрешение одной операцией
- собрать PNG по шаблону из набора данных
- проверить цену операции до её запуска
Примеры запросов агенту
- Сгенерируй три варианта обложки по промпту и покажи ссылки
- Прогони
hero.pngчерезremove_bgсwait: true - Сохрани эту цепочку шагов как пресет и верни
slug@version
Как установить ImageStep
1Командой платформы
claude mcp add mcp -e IMAGESTEP_API_KEY=<IMAGESTEP_API_KEY> -- npx -y @imagestep/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.imagestep.dev/mcp1Командой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.imagestep.dev/mcp2Командой платформы
codex mcp add mcp --env IMAGESTEP_API_KEY=<IMAGESTEP_API_KEY> -- npx -y @imagestep/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.imagestep.dev/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@imagestep/mcp"
],
"env": {
"IMAGESTEP_API_KEY": "<IMAGESTEP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.imagestep.dev/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@imagestep/mcp"
],
"env": {
"IMAGESTEP_API_KEY": "<IMAGESTEP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.imagestep.dev/mcp2Командой платформы
gemini mcp add -e IMAGESTEP_API_KEY=<IMAGESTEP_API_KEY> mcp npx -y @imagestep/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ImageStep
Как установить ImageStep в Claude Code?
Через stdio: claude mcp add mcp -e IMAGESTEP_API_KEY=<IMAGESTEP_API_KEY> -- npx -y @imagestep/mcp. Либо подключите хостинг: claude mcp add --transport http mcp https://mcp.imagestep.dev/mcp.
Что делает ImageStep?
Даёт агенту инструменты для генерации и обработки изображений: пресеты, ассеты и задания. Ответ приходит идентификаторами ассетов и ссылками, а не самими картинками.
Чем синхронный режим transform отличается от задания?
Синхронный режим работает с одним локальным файлом или URL, детерминированной операцией и wait: true, и ничего не сохраняет в аккаунте. Всё остальное — несколько картинок, asset_ids, любая AI-операция или wait: false — идёт заданием с прогрессом и отменой.
