diivi/aseprite-mcp
Aseprite MCP is a Model Context Protocol (MCP) server that enables AI assistants to create and manipulate pixel art directly within Aseprite, a popular pixel art editor. It exposes Aseprite's comprehensive scripting API as a set of MCP tools, allowing AI models to perform drawing operations, manage layers and frames, and automate sprite creation workflows. The server communicates with Aseprite via its local API, translating high-level AI instructions into precise pixel manipulations, including drawing primitive shapes like pixels, lines, rectangles, ellipses, polygons, and paths, as well as applying fills and gradients. It properly handles coordinate systems, including cel position offsets, ensuring accurate rendering across complex sprite sheets. Built in Python, the server is designed to be run as a subprocess, interfacing with MCP clients such as Claude or other AI hosts via standard I/O. It requires a local installation of Aseprite (v1.3+), and can be deployed using pip for Python environments or via a Docker container for consistent cross-platform execution. The project includes a comprehensive test suite and supports CI/CD through GitHub Actions, emphasizing reliability for automated art generation pipelines. Key features include the ability to programmatically create and modify sprites, animations, and tilesets from natural language descriptions, making it valuable for rapid prototyping in game development or generating large volumes of art assets. The server maintains accurate sprite-global coordinates, a recent fix that addresses edge cases with trimmed cels, ensuring drawing commands land at the correct pixel locations regardless of canvas adjustments. By bridging AI reasoning with pixel art creation, Aseprite MCP opens up possibilities for generative art experiments, AI-assisted content creation, and educational tools that teach pixel art concepts interactively. Its open-source nature encourages community contributions and customization for specialized wo
- Category
- Developer Tools
- Pricing
- Open Source
Problem solved
Digital artists and game developers often spend significant time manually creating pixel art assets, which can be slow and repetitive. AI assistants lack native integration with professional pixel art tools like Aseprite, leaving no direct way to translate natural language requests into actual sprite edits. Aseprite MCP solves this by providing a seamless bridge: an AI can now command Aseprite to draw, modify, and export pixel art automatically, reducing manual effort and enabling rapid iteration of graphic assets for games and applications.
Use cases
- AI-driven generation of sprite sheets for 2D games from text descriptions.
- Automated recoloring, resizing, or applying filters to batches of existing pixel art assets.
- Rapid prototyping of UI elements like buttons, icons, and borders in pixel art style.
- Interactive pixel art tutorials where an AI guides users through drawing techniques.
- Generative art experiments where AI explores creative pixel patterns and animations.
- Integration into game development CI/CD pipelines to auto-generate placeholder or final art.
Audience
- Developers
- ML Engineers
- Content Creators
- Researchers
Pros
- Enables AI-controlled pixel art creation directly in a professional editor.
- Exposes a rich set of drawing and sprite manipulation tools via MCP.
- Open source and self-hostable, ensuring data privacy and customization.
- Docker support simplifies setup across different environments.
- Actively maintained with bug fixes for coordinate accuracy.
Cons
- Requires a licensed copy of Aseprite (one-time purchase, not free).
- Limited to Aseprite's API capabilities; cannot create effects beyond its feature set.
- Relatively new project with a small community and limited third-party extensions.
Official website: https://github.com/diivi/aseprite-mcp
Canonical LambdaBase page: https://www.lambdabase.com/tools/diivi-aseprite-mcp