Aseprite

A Model Context Protocol (MCP) server for Aseprite.

Features

• Procedural Script Execution: Run custom Lua scripts to programmatically draw and manipulate sprites inside Aseprite.
• Semantic Tools: Add animations, draw assets (grass, stone), and create projects.
• Visual Feedback: Most drawing operations return a PNG preview to the LLM.
• Security: Temporary Lua scripts are safely execution-bound and cleaned up.

Setup

1. Install Aseprite.
2. Clone this repo and install dependencies:

   pnpm install
   pnpm run build
   

3. (Optional) Copy .env.example to .env and set ASEPRITE_PATH if it's not in your system PATH.

Usage with Claude Desktop

Add the following to your Claude Desktop config:

{
  "mcpServers": {
    "aseprite": {
      "command": "node",
      "args": ["/path/to/aseprite_mcp/dist/index.js"],
      "env": {
        "ASEPRITE_PATH": "aseprite"
      }
    }
  }
}

Security Note

• Never commit your .env file.
• Temporary Lua scripts are automatically cleaned up after execution. An MCP to integrated LLMs with Aesprite