whatisgithub

What is ase-mcp?

logiksecurity/ase-mcp — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

An MCP bridge that lets an AI agent draw and animate directly inside a live, editable Aseprite pixel art session.

Mindmap

mindmap
  root((ase-mcp))
    What it does
      AI controls live Aseprite
      Drawing and animation tools
      Exports sprite sheets
    Tech stack
      Python
      Lua
      Aseprite extension
    Use cases
      Generate pixel art with AI
      Automate sprite animation
      Run agent from a VM
    Audience
      Game developers
      Pixel artists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Have an AI agent draw pixel art directly inside a live Aseprite session.

USE CASE 2

Automate creating and tagging animation frame sequences for game sprites.

USE CASE 3

Export a finished animation as a sprite sheet with a data file.

USE CASE 4

Run the AI agent from a separate virtual machine while Aseprite stays on the host.

What is it built with?

PythonLuaFastMCPWebSocket

How does it compare?

logiksecurity/ase-mcp0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Windows as the Aseprite host, and extra setup scripts if the AI agent runs inside a separate VM.

Use freely for any purpose, including commercial use, as long as you keep attribution and license terms.

So what is it?

ase-mcp is a bridge that lets an AI agent control a real, currently open session of Aseprite, a popular pixel art and animation program, using a standard called the Model Context Protocol. Instead of generating a flat image file behind the scenes, the AI draws directly inside a live, editable Aseprite project, so you can watch pixels appear, layers get added, and animation frames get created in real time, then keep editing the result yourself afterward. Installing it on the Aseprite side is a single extension file that bundles both the Aseprite plugin and the small server that talks to the AI agent. Once added through Aseprite's extension menu, it starts itself automatically every time Aseprite opens. The AI agent can either run on the very same computer or inside a separate virtual machine, with setup scripts provided to wire up networking and a security token for the virtual machine case. The bridge exposes around thirty three individual tools the AI can call: things like drawing individual pixels or shapes, filling areas with color, adding and duplicating layers and animation frames, creating tagged animation sequences with named playback directions, reading pixel colors back out, and exporting a finished sprite sheet. One of the tools allows running arbitrary custom code inside Aseprite for more advanced control. Because giving an AI agent the ability to run code and launch a program on your computer is inherently risky, the project requires a shared secret token for communication, keeps the server listening only on the local machine by default, and restricts where exported files can be saved. The project notes that people should read its security documentation before opening the connection up beyond a single machine. This tool currently targets Windows as the host operating system running Aseprite, and is released under the Apache 2.0 license, which permits free use, modification, and commercial use as long as attribution and license terms are preserved.

Copy-paste prompts

Prompt 1
Explain how ase-mcp's Aseprite plugin connects to the MCP server over WebSocket.
Prompt 2
Walk me through setting up ase-mcp so an agent in a VM can reach my host's Aseprite.
Prompt 3
Show me how to use ase-mcp's draw_pixels and create_tag tools to build an animation.
Prompt 4
Summarize the security precautions ase-mcp takes since run_lua allows arbitrary code.

Frequently asked questions

What is ase-mcp?

An MCP bridge that lets an AI agent draw and animate directly inside a live, editable Aseprite pixel art session.

What language is ase-mcp written in?

Mainly Python. The stack also includes Python, Lua, FastMCP.

What license does ase-mcp use?

Use freely for any purpose, including commercial use, as long as you keep attribution and license terms.

How hard is ase-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ase-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.