diivi/aseprite-mcp

MCP server for interacting with the Aseprite API

What it solves

This project provides a Model Context Protocol (MCP) server that allows AI assistants to control Aseprite, a professional pixel art and animation tool. It bridges the gap between LLMs and graphic software, enabling AI to create, edit, and animate pixel art end-to-end without requiring the user to manually perform the drawing operations.

How it works

The server implements 104 tools across 17 categories, allowing an LLM to perform a wide range of operations. It interacts with Aseprite's Lua API to execute commands. The AI can create canvases, draw shapes, manage layers and frames, apply effects like dithering and outlines, and handle complex animation tasks such as tweening and onion-skinning. To ensure quality, the AI can export frames for visual feedback, analyze color statistics, and run a raw Lua escape hatch for custom scripts.

Who it’s for

  • AI Developers building agents that can generate pixel art and animations.
  • Game Developers who want to use AI to rapidly prototype sprites and animation sequences.
  • Pixel Artists looking to automate repetitive tasks within Aseprite using an LLM.

Highlights

  • Comprehensive Toolset: 104 tools covering everything from basic drawing to advanced animation and tilemap editing.

  • Visual Feedback Loop: Tools like export_frame and render_onion_skin allow the AI to see and iterate on its work.

  • Advanced Pixel Art Techniques: Built-in support for shading ramps with hue shifting, ordered dithering, and retro palette presets.

  • Animation Suite: Tools for easing, oscillation, and frame diffing to ensure smooth motion continuity.

  • ** uma Raw Lua Escape Hatch**: Ability to run arbitrary Lua scripts for operations not covered by the dedicated tools.

Related

  • Project
  • Project
  • Project
  • Project
  • Project