Aseprite MCP: рисование и анимация пиксель-арта через Claude и Cursor

diivi/aseprite-mcp· Проверено 12.11.2026· 986на GitHub

Даёт агенту рисовать пиксель-арт в Aseprite через пакетный режим: спрайты, слои, палитры, анимация с тегами, тайлмапы и экспорт в PNG, GIF и спрайт-листы.

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

123 инструмента на Python: рисование по символьной карте, эффекты и дизеринг, твины с easing, ретро-палитры, просмотр спрайта прямо в ответе модели.

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

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

Python 3.13 или новее и uv

Склонировать репозиторий

Установленный Aseprite; если его нет в PATH, задайте ASEPRITE_PATH в файле .env

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

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

claude mcp add --transport stdio aseprite \
  -- uv --directory '<путь к aseprite-mcp>' run -m aseprite_mcp

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

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

[mcp_servers.aseprite]
command = "uv"
args = ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]

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

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

{
  "mcpServers": {
    "aseprite": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

{
  "mcpServers": {
    "aseprite": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

{
  "mcpServers": {
    "aseprite": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

{
  "mcpServers": {
    "aseprite": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "aseprite": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к aseprite-mcp>",
          "run",
          "-m",
          "aseprite_mcp"
        ]
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "aseprite": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

{
  "mcpServers": {
    "aseprite": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "-m", "aseprite_mcp"]
    }
  }
}

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

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

create_canvasсоздаёт спрайт

add_layerдобавляет слой

draw_rowsрисует по символьной карте

draw_rectangle_atрисует прямоугольник на слое

fill_area_atзаливает область

quantize_to_paletteприводит пиксели к палитре

draw_textпишет текст пиксельным шрифтом

outline_celобводит контур в 1 пиксель

adjust_hslсдвигает тон и яркость

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

generate_color_rampстроит рампу оттенков

apply_palette_presetставит ретро-палитру

propagate_celsкопирует кадры слоя

tween_cel_positions_easedдвигает кадр с easing

oscillate_cel_positionsраскачивает по синусоиде

view_spriteпоказывает спрайт модели

lint_spriteищет одиночные пиксели

export_animationвыгружает GIF или PNG

export_spritesheetсобирает спрайт-лист

run_lua_scriptвыполняет скрипт Lua

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

165 инструментов с упором на проверку результата: тени по рампе и источнику света, замеры кадров и циклов, заготовки персонажа и тайлсета, экспорт в Godot и Minecraft.

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

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

Aseprite 1.3 или новее, сборка Steam или отдельная

Python 3.10 или новее и uv

Склонировать репозиторий и выполнить uv sync

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

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

claude mcp add --env 'ASEPRITE_PATH=<путь к Aseprite.exe или aseprite>' --transport stdio aseprite-mcp \
  -- uv --directory '<путь к aseprite-mcp>' run aseprite-mcp

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

[mcp_servers.aseprite-mcp]
command = "uv"
args = ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"]

[mcp_servers.aseprite-mcp.env]
ASEPRITE_PATH = "<путь к Aseprite.exe или aseprite>"

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

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "aseprite-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "aseprite-mcp": {
        "type": "local",
        "command": ["uv", "--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
        "environment": {
          "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "uv",
      "args": ["--directory", "<путь к aseprite-mcp>", "run", "aseprite-mcp"],
      "env": {
        "ASEPRITE_PATH": "<путь к Aseprite.exe или aseprite>"
      }
    }
  }
}

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

create_spriteсоздаёт спрайт

draw_pixel_mapрисует по символьной карте

make_4_frame_idle_animationделает 4-кадровую анимацию ожидания

export_game_asset_bundleвыгружает комплект для игры

shade_region_by_lightзатеняет форму по свету

outline_smartобводит цветами рампы

gradient_mapпереводит цвета на рампу

tween_celsсжимает и вращает по кадрам

smear_frameрисует смаз движения

apply_timing_curveзадаёт тайминг цикла

validate_loopпроверяет зацикленную анимацию

assess_spriteоценивает рисунок

diff_spritesсравнивает кадры

render_previewрендерит кадр для просмотра

create_character_spriteзаготавливает персонажа

scaffold_cycleзаготавливает цикл ходьбы или атаки

export_godot_spriteframesвыгружает SpriteFrames для Godot

export_minecraft_textureкладёт текстуру в ресурспак

apply_operationsприменяет пакет правок разом

health_checkпроверяет связь с Aseprite

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

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

«Нарисуй зелёного слизня 32×32 и анимируй прыжок вправо со сжатием и растяжением»diivi: create_canvas, draw_rows, затем propagate_cels и tween_cel_positions_eased; результат проверит view_sprite

«Сделай героя с анимацией ожидания и выгрузи комплект для игры»MalloyTheDev: create_character_sprite, затем make_4_frame_idle_animation и export_game_asset_bundle

«Поставь палитру PICO-8 и перекрась спрайт в неё»Агент вызовет apply_palette_preset с pico8 и quantize_to_palette

«Затени ящик со светом слева сверху»MalloyTheDev вызовет shade_region_by_light с рампой и направлением света

«Выгрузи анимацию для Godot 4»MalloyTheDev вызовет export_godot_spriteframes: SpriteFrames .tres и упакованный лист

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

Нарисовать спрайт персонажа или предмета по слоям с палитрой под материал

Анимировать удар, прыжок или покачивание и проверить цикл по кадрам

Затенить форму по одному источнику света, оставаясь в палитре

Собрать тайлсет и разложить тайлы по карте

Выгрузить анимацию в GIF, спрайт-лист с JSON или SpriteFrames для Godot

Ограничения

Оба сервера сторонние: Aseprite нужно поставить самому, сервер запускает его в пакетном режиме

У Aseprite MCP (MalloyTheDev) 25 звёзд, репозиторий создан в июне 2026

У MalloyTheDev каждый вызов — отдельный процесс Aseprite: история отмены между вызовами не сохраняется; сохранение в PNG или GIF сводит слои

Запуск Aseprite дольше 60 секунд diivi прерывает с ошибкой, MalloyTheDev — через 90 секунд; пределы меняются в ASEPRITE_TIMEOUT_SECONDS и ASEPRITE_MCP_TIMEOUT

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

Could not locate Aseprite

Задайте ASEPRITE_PATH с полным путём к исполняемому файлу Aseprite.

Ничего не происходит или permission denied при сохранении

Папка рабочего пространства недоступна для записи: проверьте ASEPRITE_MCP_WORKSPACE, health_check покажет, куда на деле ложатся файлы.

Большие операции падают по таймауту

Поднимите ASEPRITE_MCP_TIMEOUT у MalloyTheDev или ASEPRITE_TIMEOUT_SECONDS у diivi.

Инструмент падает с сообщением Lua

Сообщение приходит из Aseprite как есть и обычно называет неверный аргумент, например несуществующий слой или кадр.

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

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Aseprite MCP Tools	diivi	986	локально	не нужен	123	3 ноября 2026
Aseprite MCP (MalloyTheDev)	MalloyTheDev	25	локально	не нужен	165	8 ноября 2026

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

Какой сервер выбрать?

Aseprite MCP Tools от diivi проще: 123 инструмента и инструмент view_sprite, через который модель видит свою работу. Вариант MalloyTheDev больше про замеры и игровой экспорт: оценка рисунка, сравнение кадров, проверка циклов, Godot и Minecraft.

Видит ли модель, что нарисовала?

Да. У diivi view_sprite возвращает картинку с сеткой и линейками прямо в ответ. У MalloyTheDev render_preview рендерит кадр, а assess_sprite и diff_sprites меряют рисунок для моделей без зрения.

Останутся ли файлы редактируемыми?

Да, если сохранять в .aseprite или .ase: слои, кадры и теги сохраняются. Сохранение в .png или .gif сводит слои.

Можно ли смотреть, как агент рисует?

У MalloyTheDev open_in_editor открывает спрайт в окне Aseprite, чтобы следить за правками. У diivi есть локальный HTTP-сервер для просмотра выгруженных файлов: start_preview_server.

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

Для MalloyTheDev: claude mcp add aseprite -- uv --directory <путь к клону> run aseprite-mcp, при необходимости с --env ASEPRITE_PATH=<путь к Aseprite>. Для diivi откройте вкладку Claude Code в блоке «Как подключить».

Что такое Aseprite MCP Pro?

Это проект youichi-uda: в его репозитории лежит только Lua-расширение для Aseprite, а MCP-сервер автор обещает в полной версии, ссылка на покупку пока помечена coming soon. Поэтому отдельным вариантом на странице его нет.

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

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

Aseprite MCP: рисование и анимация пиксель-арта через Claude и Cursor

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

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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