Skip to main content
Glama

Aseprite MCP Server & Multi-Agent Asset Pipeline

Model Context Protocol (MCP) server & automated Multi-Agent Asset Pipeline for automating Aseprite to create, edit, animate, and export game assets.


Multi-Agent Architecture (Asset Pipeline)

[Gambar Referensi / Prompt Anda]
             │
             ▼
 ┌───────────────────────┐
 │ 1. Vision & Style     │ ──> Ekstrak Palette (HEX), Style Shading, 
 │    Analyzer Agent     │     Ketebalan Outline, & Grid Resolution
 └───────────────────────┘
             │ (Style Specification Spec: style_spec.json)
             ▼
 ┌───────────────────────┐
 │ 2. Game Asset         │ ──> Menerjemahkan Ide Objek ke Bentuk Geometri /
 │    Architect Agent    │     Silhouette Piksel & Keyframe Animasi
 └───────────────────────┘
             │ (Asset Blueprint Spec: blueprint_spec.json)
             ▼
 ┌───────────────────────┐
 │ 3. Aseprite Scripting │ ──> Menyusun Kode Lua (Layering, Mirroring,
 │    Engineer (MCP)     │     Canvas, Color Indexing, Cel Transforms)
 └───────────────────────┘
             │ (Output: build.lua)
             ▼
  [Aseprite CLI / Socket] ──> Langsung Terbuka di Canvas Aseprite Anda!

Related MCP server: Aseprite MCP Tools

Folder Structure

  • references/: Taruh gambar referensi Anda di sini (.png, .jpg, .jpeg).

  • output/<folder-baru>/: Setiap pembuatan aset dikelompokkan ke dalam subfolder tersendiri:

    • style_spec.json (Spesifikasi gaya dari Agent 1)

    • blueprint_spec.json (Spesifikasi struktur & animasi dari Agent 2)

    • build.lua (Script Lua dari Agent 3)

    • <asset>.aseprite (Master file Aseprite lengkap dengan layer & tags)

    • <asset>_sheet.png (Atlas spritesheet)

    • <asset>_sheet.json (Metadata JSON atlas untuk Godot / Unity)

    • <asset>_<tag>.gif (Animasi per aksi)

    • <asset>_preview.png (Preview still frame resolusi tinggi)


Quickstart

# Install dependencies
bun install
# atau
npm install

# Build TypeScript
bun run build
# atau
npm run build

Complete Indonesian Guide

Panduan lengkap dalam Bahasa Indonesia: 👉 PANDUAN_INTEGRASI.md

Available Tools

12 tools
aseprite_analyze_styleC

Extract palette (HEX), shading style, outline rules, and grid specs from a reference image or text prompt.

Inputs: prompt (required), width, height, referenceImage.

aseprite_apply_paletteC

Apply a color palette preset (e.g. 'pico-8', 'endesga-32', 'gameboy') or custom hex colors to a sprite.

Inputs: filepath (required), customPalette, palettePreset.

aseprite_convertC

Convert a sprite file to another format (.png, .gif, .aseprite) with optional pixel-perfect integer scaling (e.g. 2x, 4x, 8x).

Inputs: inputPath (required), outputPath (required), scale, frameRange.

aseprite_create_animationC

Add animation frames, configure frame durations (ms), and set animation tags (e.g. 'idle', 'walk', 'jump').

Inputs: filepath (required), tags, totalFrames, frameDurations, +1 more.

aseprite_create_spriteC

Create a new sprite file (.aseprite or .png) with custom dimensions, color mode, layers, frames, and palette.

Inputs: filepath (required), width, frames, height, +4 more.

aseprite_draw_pixelsB

Draw pixels or a 2D character matrix onto a specific layer and frame of an existing sprite.

Inputs: filepath (required), frame, layer, matrix, +2 more.

aseprite_export_spritesheetC

Export a sprite or animation into a packed spritesheet texture (.png) and metadata (.json) for game engines.

Inputs: filepath (required), sheetPath (required), trim, format, +7 more.

aseprite_get_infoA

Get Aseprite executable path, version, and test CLI/Lua scripting capability.

Inputs: no named parameters.

aseprite_inspect_spriteB

Inspect an existing sprite file (.aseprite or image) to read dimensions, layers, frames, animation tags, and palette.

Inputs: filepath (required).

aseprite_open_in_guiC

Directly open an .aseprite file on your screen inside the Aseprite GUI window.

Inputs: filepath (required).

aseprite_run_luaB

Execute arbitrary Lua script inside Aseprite headless environment for advanced custom workflows.

Inputs: code (required), params.

aseprite_run_pipelineB

Run the 3-stage Multi-Agent Asset Pipeline (Vision & Style Analyzer -> Game Asset Architect -> Scripting Engineer). Outputs all files grouped in a dedicated folder in /output//.

Inputs: prompt (required), width, height, assetName, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have clearly distinct resource+action targets, but aseprite_run_lua and aseprite_run_pipeline both execute workflows and could be confused, and aseprite_analyze_style partially overlaps palette/inspection concerns of aseprite_apply_palette and aseprite_inspect_sprite.

    Naming Consistency5/5

    Every tool uses the aseprite_ prefix with a consistent verb_noun pattern (create_sprite, draw_pixels, apply_palette, export_spritesheet, inspect_sprite, run_lua), making the set highly predictable.

    Tool Count5/5

    12 tools is a well-scoped size for a sprite-editing server, covering distinct phases (info, create, draw, animate, palette, export, inspect) without obvious redundancy.

    Completeness4/5

    Core pixel-art lifecycle is covered from creation through drawing, animation, palette, export, and inspection, but there are gaps in editing existing sprites (e.g. add/remove layers or frames, delete/resize operations) that could create dead ends for iterative workflows.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding agents to create, draw, and refine Aseprite documents through deterministic canvas, layer, frame, tag, and palette tools, with pixel analyzers, style validation, and preview/diff visual feedback. It also supports spritesheet and animated GIF export, producing multi-layer game-ready assets.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to create and edit pixel art and animated sprites in Aseprite through 104 tools covering drawing, layers, animation, palettes, tilemaps, exports, visual analysis, and raw Lua scripting.
      116
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables an AI agent to create and edit pixel art directly in Aseprite — building sprites, layers, frames, animation tags and palettes, painting pixels and primitives, inspecting the rendered result, and exporting GIFs or sprite sheets. All work lands on real .aseprite files that can be opened and edited by hand.
      43
      157 npm
      1
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to create and edit pixel art and sprite animations by driving Aseprite's 73 tools for sprites, layers, frames, cels, drawing, selections, palettes, tags, slices, tilemaps, filters and export, with a generic escape hatch to any of its 183 menu commands or Lua scripting API. It runs either headless in batch mode on files or live against an open Aseprite window so edits are visible and undoable.
      73
      157 npm
      2
      MIT