Aseprite MCP Server

A Model Context Protocol (MCP) server for Aseprite.

Features

• AI Sprite Generation: Create base pixel art using fal.ai.

• Semantic Tools: Add animations, draw assets (grass, stone), and create projects.

• Visual Feedback: All operations return a PNG preview to the LLM.

• Security: API keys are managed via .env.

Related MCP server: Aseprite-MCP

Setup

1. Install Aseprite.

2. Clone this repo and install dependencies:

   pnpm install
   pnpm run build

3. Copy .env.example to .env and add your FAL_KEY.

4. (Optional) 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": {
        "FAL_KEY": "your_key_here",
        "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