Lentera Aseprite MCP Server

Custom Model Context Protocol (MCP) Server yang dirancang khusus untuk mengotomatisasi manipulasi pixel art, layer, frame animasi, quantize palet, slicing, dan ekspor spritesheet pada Aseprite untuk proyek Lentera Pudar.

---

Arsitektur Sistem

Server ini menghubungkan AI Agent ke Aseprite Editor secara real-time melalui WebSocket dan Lua Extension Bridge:

• AI Agent / Antigravity <--> (Stdio / MCP Protocol) <--> Lentera Aseprite MCP Server (TypeScript)
• Lentera Aseprite MCP Server <--> (WebSocket Bridge) <--> Aseprite Lua Extension (lua-extension/bridge.lua)
• Aseprite Lua Extension <--> (Aseprite Lua API pp.)* <--> Aseprite Canvas Engine

---

Fitur & Kategori Tool

Server ini menyediakan lebih dari 40 tools otomasi pixel art yang dikelompokkan ke dalam beberapa modul:

Modul	File Handler (src/tools/)	Deskripsi Kemampuan
Drawing & Canvas	drawing.ts, sprite.ts	Menggambar pixel, garis, kotak, elips, fill area, outline, flip, rotate, resize kanvas, dan zoom fit.
Layers & Cels	layer.ts	Menambah/menghapus layer, mengatur opacity, visibility, blend mode, merge layers, dan navigasi active cel.
Frames & Animation	rame.ts, ag.ts	Menambah frame, mengatur durasi frame (ms), membuat tag animasi (idle_south, walk_north), dan navigasi frame.
Palette Management	palette.ts	Load palet resmi Lentera Pudar (load_palette_lentera), replace color, color quantization, dan resize palet.
Exporting	export.ts	Ekspor frame tunggal, ekspor spritesheet horizontal/vertikal, ekspor Godot SpriteFrames (.tres), dan ekspor Godot TileSet.
Scripting & Visual	misc.ts	Eksekusi script Lua dinamis via
un_lua_script, capture screenshot Aseprite, dan canvas preview.

---

Cara Instalasi & Menjalankan

1. Build Server MCP

Pastikan Anda memiliki Node.js (v18+) terinstal: ash npm install npm run build

2. Pasang Lua Extension ke Aseprite

Buka Aseprite, pilih Edit -> Preferences -> Extensions -> Add Extension, lalu arahkan ke folder lua-extension/ di dalam repo ini (atau salin ke direktori ekstensi Aseprite Anda).

3. Konfigurasi di Antigravity IDE (mcp_config.json)

json { mcpServers: { lentera-aseprite: { command: node, args: [D:/GodotProjects/lentera-aseprite-mcp/build/index.js] } } }

---

Lisensi

Dibuat secara kustom untuk ekosistem game Lentera Pudar.