Aseprite MCP Tools

Установка

Работает в

• Claude Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{"mcpServers": {"aseprite": {"type": "stdio", "command": "uv", "args": ["--directory", "/path/to/aseprite-mcp", "run", "-m", "aseprite_mcp"], "env": {}}}}

Что делает

Aseprite MCP Tools запускает Aseprite в пакетном режиме и превращает его возможности в инструменты MCP. Агент создает холст, добавляет слои и группы, рисует пиксели, линии, многоугольники, изометрические коробки, заливает градиентом и размечает тайлмапы. Для мелких деталей есть draw_rows: рисунок задается строками символов и легендой цветов, как в ASCII-арте, а read_rows возвращает участок в том же виде, так что правка сводится к замене нескольких символов. Отдельный набор работает с цветом и стилем: готовые палитры (gameboy, pico8, c64, cga, dawnbringer16 и другие), градиенты теней со сдвигом оттенка, привязка пикселей к ближайшему цвету палитры, упорядоченный дизеринг и обводка. Анимация собирается из кадров, заданной длительности каждого кадра и тегов, а промежуточные положения ячеек анимации считаются с плавными переходами. Результат уходит в PNG, GIF, спрайт-лист или по слоям. Для обратной связи служит view_sprite: он возвращает картинку прямо модели, с сеткой пикселей и линейками координат, а render_onion_skin, compare_frames, lint_sprite и get_color_stats показывают, что поплыло между кадрами и где остались одиночные пиксели.

Для кого. Для разработчиков игр и пиксель-художников, которые хотят поручить агенту спрайты, тайлы и короткие анимации в Aseprite и затем доработать файлы руками.

Пример запроса к агенту

Нарисуй в Aseprite зеленого слизня 32×32 в палитре pico8, сделай 8 кадров прыжка со сжатием и растяжением и выгрузи GIF с увеличением 8×

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

• Нужны Python 3.13 или новее, пакетный менеджер uv и установленный Aseprite. Если программы нет в PATH, путь задает переменная ASEPRITE_PATH.
• Установки через uvx или pip в инструкции нет: сервер запускают из клонированного репозитория командой uv run -m aseprite_mcp.
• Aseprite в Docker-образ не входит. Его можно доставить при запуске через SteamCMD, но для этого нужны данные аккаунта Steam, а при включенной защите и код Steam Guard.
• Качество рисунка зависит от модели, подключенной к агенту.

Как отключить. Удалите блок aseprite из mcpServers в настройках клиента или из файла .mcp.json проекта и перезапустите агента. Контейнер останавливается командой docker stop. Готовые .aseprite, PNG и GIF остаются там, куда агент их сохранил, а папка ~/.aseprite-mcp/fonts хранит только добавленные вами шрифты.

Коротко о README

Страница репозитория открывается галереей работ, сделанных через сервер, и таблицей из 18 категорий инструментов: от холста и рисования до тайлмапов, анализа кадров и скриптов. Каждую категорию разбирает отдельный раздел с таблицей инструментов и примерами вызовов, например с draw_rows и measure_text. Затем идет рекомендуемый порядок работы для модели из шести шагов, от выбора палитры до экспорта анимации. Завершают страницу запуск в Docker, локальная установка и конфигурация MCP.