Aseprite MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ASEPRITE_PATH | No | Absolute path to your Aseprite application. | |
| ASEPRITE_MCP_TOOL_PROFILE | No | Selects the tool scope. `all` (default) enables live and CLI tools; `core` enables 9 live core entries (10 when animation is enabled); `cli` enables 116 disk file tools without a live connection. | all |
| ASEPRITE_MCP_CAPABILITY_SETS | No | Optional capability set. Set to `animation` to additionally provide the `apply_animation` tool. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_connection_statusA | 读取实时会话、软件版本、本机端点及已启用能力集。 |
| list_documentsC | 列出显式编辑器会话中的内存文档。 |
| get_document_infoC | 读取显式内存文档,标识仅在当前会话有效。 |
| read_pixelsA | 读取普通 RGB 图层原始像素(不合成透明度)。region={x,y,width,height}; 按行优先返回 pixels=[[r,g,b,a],...] 或 encoding=rle 的 runs=[{count,rgba},...]。 空 Cel 返回透明像素,帧从1开始,必须匹配 expected_revision。 |
| create_spriteC | 创建未保存的 RGB 文档。 |
| apply_operationsA | 在指定修订执行原子批次,一次撤销。layer={kind:id或ref,value:标识},frame默认1。 支持 create_layer(ref,name)、set_opacity(layer,opacity)、pixel(layer,x,y,rgba)、 rectangle/ellipse(layer,x,y,width,height,rgba,filled=true)、pixels(layer,points=[{x,y,rgba}])、 line(layer,x1,y1,x2,y2,rgba,thickness=1)、clear_region(layer,x,y,width,height)、 write_region(layer,x,y,width,height,encoding=rgba|rle,mode=replace|source_over, pixels=[[r,g,b,a],...]或runs=[{count,rgba},...])。区域像素按行优先,RGBA为0–255整数。 |
| get_previewC | 直接返回指定修订/帧的 PNG 图片及元数据;整数最近邻缩放。 |
| save_spriteC | 显式保存文档;未命名文档必须指定路径。 |
| undoD | 撤销显式文档,要求匹配修订。 |
| redoC | 重做显式文档,要求匹配修订。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool has a largely distinct purpose: apply_operations mutates, read_pixels returns raw RGBA, get_preview returns a PNG, and get_document_info returns metadata. The read-oriented trio (read_pixels/get_preview/get_document_info) could occasionally be confused since all surface document state, but the descriptions clarify the differing output formats.
Most tools follow a clear verb_noun pattern (read_pixels, create_sprite, get_preview, list_documents, save_sprite, get_connection_status). The only deviations are the conventional bare undo/redo, which is a minor, readable exception rather than a convention break.
Ten tools is well-scoped for a sprite editor integration, and the heavy drawing surface is wisely consolidated into a single apply_operations batch tool rather than exploding into dozens of individual drawing tools. Each tool earns its place.
Core flows (create, draw/batch-edit, read, save, undo/redo) are covered, but notable gaps remain for an animation-oriented tool: no frame creation/management despite frame-indexed tools, no delete_layer or close/delete document, and no export beyond save. These missing operations will create dead ends for animation or cleanup workflows.