Skip to content
Back to search

aseprite-mcp

MCP server for interacting with the Aseprite API

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/diivi--aseprite-mcp/badge.svg)](/listings/diivi--aseprite-mcp)

HTML

<a href="/listings/diivi--aseprite-mcp"><img src="/api/listings/diivi--aseprite-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Build and run the Docker image:

docker build -t aseprite-mcp:latest .
docker run -it --rm aseprite-mcp:latest

Or use the provided build scripts: - **Linux/macOS**: `chmod +x build-docker.sh && ./build-docker.sh` - **Windows**: `.\build-docker.ps1`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 436 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Aseprite MCP Tools
  2. A Python MCP server that gives AI assistants full control over [Aseprite](https://www.aseprite.org/) for creating pixel art and animated sprites.
  3. **123 tools across 18 categories** — canvas, drawing, layers, animation, palettes, effects, slices, tilemaps, exports, visual-feedback/analysis tools, and a raw Lua escape hatch. The tool set is designed so an LLM has everything it needs to produce *good* pixel art, not just primitives: shading ramps with hue shifting, ordered dithering, outlines, retro palette presets with quantization, onion-skin renders, and frame diffing, bounds and lint checks for animation work.
  4. ## Examples
  5. ### Cosy room (Opus 5.5)
  6. <table>
  7. <tr>
  8. <td align="center"><img src="examples/cosy_room/cosy_room.gif" width="512" alt="Animated isometric pixel-art bedroom at dusk with a girl doing homework and a cat asleep on the bookshelf, by Claude Opus 5.5"></td>
  9. </tr>
  10. <tr>
  11. <td align="center"><sub>An isometric bedroom at dusk with a girl doing her homework, animated as a lofi-style loop.<br>128×128, 16-frame loop, exported at 4×.</sub></td>
  12. </tr>
  13. </table>
  14. ### Swordsman: Fable 5 vs Opus 5.5
  15. <table>
  16. <tr>
  17. <th>Fable 5</th>
  18. <th>Opus 5.5</th>
  19. </tr>
  20. <tr>
  21. <td align="center"><img src="examples/swordsman/swordsman.png" width="256" alt="Pixel-art swordsman drawn by Claude Fable 5"></td>
  22. <td align="center"><img src="examples/swordsman/opus_redraw.png" width="256" alt="The same swordsman redrawn by Claude Opus 5.5"></td>
  23. </tr>
  24. <tr>
  25. <td align="center"><img src="examples/swordsman/swordsman_slash.gif" width="256" alt="4-frame sword slash by Claude Fable 5"></td>
  26. <td align="center"><img src="examples/swordsman/opus_redraw_slash.gif" width="256" alt="8-frame sword slash by Claude Opus 5.5"></td>
  27. </tr>
  28. <tr>
  29. <td align="center"><sub>The benchmark swordsman, then a slash from windup to follow-through.<br>48×48, 4-frame slash.</sub></td>
  30. <td align="center"><sub>Opus 5.5 critiqued the Fable 5 sprite and redrew it at the same size.<br>48×48, 8-frame slash.</sub></td>
  31. </tr>
  32. </table>
  33. The Fable 5 tasks recreate the benchmark from [Draw Me a Swordsman](https://ljvmiranda921.github.io/notebook/2025/07/20/draw-me-a-swordsman/) by Lj Miranda, whose findings inspired this server's expanded toolset.
  34. ### Slime (Opus 5.5)
  35. <table>
  36. <tr>
  37. <td align="center"><img src="examples/slime/slime.png" width="256" alt="Pixel-art green slime drawn by Claude Opus 5.5"></td>
  38. </tr>
  39. <tr>
  40. <td align="center"><sub>A green slime.<br>32×32 still, exported at 8×.</sub></td>
  41. </tr>
  42. <tr>
  43. <td align="center"><img src="examples/slime/slime_bounce.gif" width="544" alt="The slime hopping to the right with squash and stretch, by Claude Opus 5.5"></td>
  44. </tr>
  45. <tr>
  46. <td align="center"><sub>The slime bouncing to the right with squash and stretch.<br>43-frame animation, exported at 4×.</sub></td>
  47. </tr>
  48. </table>
  49. ### Swordsman vs. slime (Opus 5.5)
  50. <table>
  51. <tr>
  52. <td align="center"><img src="examples/swordsman_vs_slime/swordsman_vs_slime.gif" width="400" alt="The swordsman slashes the slime, which flashes red as a -12 damage number pops out and its health bar drops, by Claude Opus 5.5"></td>
  53. </tr>
  54. <tr>
  55. <td align="center"><sub>The swordsman slashes the slime, which flashes red, loses health and pops a damage number.<br>80×58, 15 frames, exported at 5×.</sub></td>
  56. </tr>
  57. </table>
  58. ## Related Projects
  59. [Aseprite Live](https://github.com/N7z/aseprite-live) – Watch an AI agent draw pixel art in Aseprite, live, in your browser
  60. ## Tool Categories
  61. | Category | Tools | Description |
  62. |----------|------:|-------------|
  63. | [Canvas](#canvas) | 7 | Create sprites, manage layers/frames, set the active state |
  64. | [Drawing](#drawing) | 16 | Pixels, text rows, lines, rectangles, circles, ellipses, polygons, paths, fills, gradients, isometric boxes |
  65. | [Text](#text) | 3 | Draw and measure text with bitmap sprite-sheet or TrueType fonts |
  66. | [Layers](#layers) | 7 | Delete, rename, duplicate, reorder, blend modes, merge, flatten |
  67. | [Selection & Regions](#selection--regions) | 4 | Move, copy, and erase rectangular regions or colors |
  68. | [Effects](#effects) | 12 | Outlines, color replacement, HSL adjustment, ordered dithering, native Aseprite filters |
  69. | [Animation](#animation) | 24 | Frames, cels, tags, tweening with easing, propagation |
  70. | [Palette](#palette) | 8 | Get/set palettes, retro presets, color ramps, quantization, color modes |
  71. | [Transform](#transform) | 4 | Flip, rotate, resize, crop |
  72. | [Slices](#slices) | 5 | Named regions, 9-patch centers, pivot points |
  73. | [Tilemap](#tilemap) | 5 | Tilemap layers, tileset editing, tile placement |
  74. | [Export & Import](#export--import) | 8 | PNG, GIF, sprite sheets, per-layer/per-tag export, previews on a background, image import |
  75. | [Inspection](#inspection) | 6 | Read pixels (one layer, the visible composite, or as text rows) and sprite metadata |
  76. | [Analysis & Visual Feedback](#analysis--visual-feedback) | 6 | Sprite previews the model can see, onion-skin renders, frame diffing, bounds, lint, color statistics |
  77. | [Quality](#quality) | 4 | Validate and sanitize animation consistency |
  78. | [Scene](#scene) | 1 | Copy layers between sprite files |
  79. | [Preview & Guide](#preview--guide) | 3 | Local HTTP preview server, workflow guide |
  80. | [Scripting](#scripting) | 1 | Raw Lua escape hatch for anything not covered above |
  81. ### Canvas
  82. | Tool | Description |
  83. |------|-------------|
  84. | `create_canvas` | Create a new sprite with the given dimensions |
  85. | `add_layer` | Add a new layer, optionally inside a named group |
  86. | `add_group` | Add a new (optionally nested) group layer |
  87. | `add_frame` | Append a new frame |
  88. | `set_frame` | Set the active frame |
  89. | `set_frame_duration` | Set one frame's duration in ms |
  90. | `set_layer` | Set the active layer (optionally creating it) |
  91. ### Drawing
  92. All `_at` variants target a specific layer/frame and can create the cel on demand. Coordinates are sprite-global.
  93. ```
  94. draw_rows(filename="mug.aseprite", layer_name="mug", frame_index=1, x=4, y=2,
  95. rows=[".WWWW..",
  96. ".WWWWKK",
  97. ".WWWW.K",
  98. "..WW.K."],
  99. legend={"W": "#F4F4F4", "K": "#8B5A2B"}, outline="#1A1C2C")
  100. ```
  101. `.` (or any character missing from the legend) leaves a pixel untouched; `read_rows` returns pixels in the same format, so an edit is read, change a few characters, draw again.
  102. | Tool | Description |
  103. |------|-------------|
  104. | `draw_pixels` | Plot individual pixels with per-pixel colors |
  105. | `draw_pixels_at` | Plot pixels on a specific layer/frame |
  106. | `draw_line` / `draw_line_at` | Lines with thickness |
  107. | `draw_rectangle` / `draw_rectangle_at` | Outlined or filled rectangles |
  108. | `draw_circle` / `draw_circle_at` | Outlined or filled circles |
  109. | `draw_ellipse_at` | Outlined or filled ellipses with separate x/y radii |
  110. | `draw_polygon` | Outlined or filled polygons from a point list |
  111. | `draw_path` | Polyline through a point list with thickness |
  112. | `fill_area` / `fill_area_at` | Paint-bucket flood fill |
  113. | `apply_gradient_rect` | Smooth linear gradient fill in a rectangle |
  114. | `draw_rows` | Pixels as rows of characters plus a colour legend, like ASCII art, with an optional 1px outline — the compact way to place hand-chosen detail (faces, hands, animals, handles) |
  115. | `draw_iso_box` | Solid 2:1 isometric box with clean 2-1 edges and a colour per face, for furniture and props |
  116. ### Text
  117. Aseprite's Lua API has no text drawing, so glyphs are rasterised on the server and composited into the sprite. Two font backends are supported: **bitmap** sprite-sheet fonts (the right choice for pixel art — glyphs are already pixels and `size` scales them by whole numbers) and **TrueType** `.ttf`/`.otf` files, rendered without antialiasing unless you ask for it.
  118. Fonts are discovered in `~/.aseprite-mcp/fonts`: a bitmap font is a directory containing `font.json` plus its sheet PNGs; a TrueType font is just the font file. Installed system fonts are listed too. `font` also accepts a direct path.
  119. | Tool | Description |
  120. |------|-------------|
  121. | `list_text_fonts` | List the bitmap and TrueType fonts available to `draw_text` |
  122. | `measure_text` | Width, height, advance and baseline extents — size a panel or centre a label without redrawing to find out |
  123. | `draw_text` | Draw text with anchors, faux bold, outline, drop shadow and letter spacing |
  124. Call `measure_text` first when the layout depends on the text: it returns the same metrics `draw_text` will use, so a label can be centred or a plate sized in one pass.
  125. ```
  126. measure_text(text="MODERATOR", font="minecraft", size=2, bold=1)
  127. -> width=115 height=15 advance_width=117 above_baseline=14 below_baseline=1 left_bearing=0
  128. draw_text(filename="badge.aseprite", text="MODERATOR", x=64, y=17,
  129. font="minecraft", size=2, anchor="baseline", bold=1,
  130. color="#FFFFFF", shadow_color="#14237A")
  131. ```
  132. Anchors are `topleft`/`top`/`topright`, `left`/`center`/`right`, `bottomleft`/`bottom`/`bottomright`, plus `baselineleft`/`baseline`/`baselineright` for pinning several labels to one baseline. Outline and shadow grow the stamp but never move the glyphs.
  133. #### font.json
  134. ```json
  135. {
  136. "name": "my-font",
  137. "letter_gap": 1,
  138. "space_width": 3,
  139. "sheets": [{
  140. "file": "sheet.png",
  141. "cell_w": 8, "cell_h": 8,
  142. "ascent": 7,
  143. "chars": [" !\"#$%&'()*+,-./", "0123456789:;<=>?"]
  144. }],
  145. "overrides": {
  146. "86": {"ascent": 7, "rows": ["#...#", "#...#", ".#.#.", "..#.."]}
  147. }
  148. }
  149. ```
  150. Each sheet carries its own `ascent`, so sheets with different cell sizes still share a baseline — that is how a compact ASCII sheet and a taller accented sheet combine into one run. `origin` shifts the cell grid when the sheet has a margin, `ink_rule: "dark"` reads sheets that use an opaque white background to delimit variable-width glyph boxes, and `advance: "box"` takes the advance from the box rather than the ink. `overrides` replaces individual glyphs with hand-drawn rows, which is useful when a sheet ships a glyph that is off-centre or too tall to sit on the line.
  151. ### Layers
  152. | Tool | Description |
  153. |------|-------------|
  154. | `delete_layer` | Delete a layer by name |
  155. | `rename_layer` | Rename a layer |
  156. | `duplicate_layer` | Duplicate a layer with all cels, opacity, and blend mode, optionally into a group |
  157. | `reorder_layer` | Move a layer to a position in the stack |
  158. | `set_layer_blend_mode` | Set blend mode (multiply, screen, overlay, ... 19 modes) |
  159. | `merge_layer_down` | Merge a layer into the one below it |
  160. | `flatten_sprite` | Flatten all layers into one |
  161. ### Selection & Regions
  162. | Tool | Description |
  163. |------|-------------|
  164. | `move_region` | Cut a rectangle of pixels and paste it elsewhere |
  165. | `copy_region` | Copy a rectangle to another position, layer, or frame |
  166. | `erase_region` | Make a rectangle transparent |
  167. | `erase_color` | Magic-eraser: make all pixels of a color transparent (with tolerance) |
  168. ### Effects
  169. The pixel-art toolbox: clean outlines, palette-respecting blends, and shading variants.
  170. | Tool | Description |
  171. |------|-------------|
  172. | `outline_cel` | Add a 1px outline around all opaque pixels, or only around the shapes in a region |
  173. | `replace_color` | Replace one color with another (with tolerance), preserving alpha |
  174. | `adjust_hsl` | Shift hue/saturation/lightness of a cel — palette swaps, night scenes, shadows |
  175. | `apply_dither_gradient` | Two-color gradient using Bayer 4×4 ordered dithering |
  176. | `apply_dither_pattern` | Uniform dithered mix of two colors at a given density |
  177. Native filters run Aseprite's own engine commands on a layer and frame:
  178. | Tool | Description |
  179. |------|-------------|
  180. | `outline_native` | Aseprite's Outline command around opaque pixels |
  181. | `adjust_hsl_native` | Aseprite's Hue/Saturation/Lightness filter |
  182. | `adjust_brightness_contrast` | Brightness/Contrast filter |
  183. | `invert_colors` | Colour inversion |
  184. | `apply_convolution` | Convolution filter: blur, sharpen, edge, emboss … |
  185. | `list_convolution_matrices` | List the built-in matrices for `apply_convolution` |
  186. | `extract_palette` | Build an optimal palette from the sprite (native colour quantization) |
  187. ### Animation
  188. | Tool | Description |
  189. |------|-------------|
  190. | `add_frames` | Append N frames with optional duration |
  191. | `delete_frame` | Delete a frame |
  192. | `set_frame_duration_all` | Set every frame's duration |
  193. | `duplicate_frame_range` | Duplicate a frame range N times |
  194. | `copy_frame` / `propagate_frame_to_range` | Copy all cels of a frame to other frames |
  195. | `create_cel` / `clear_cel` / `copy_cel` | Cel lifecycle on a layer/frame |
  196. | `propagate_cels` | Copy selected layers' cels across a frame range |
  197. | `set_cel_position` | Place a cel at x,y |
  198. | `set_cel_opacity` | Set a single cel's opacity |
  199. | `offset_cel_positions` | Shift cels by a delta across frames |
  200. | `tween_cel_positions` | Linear position tween across frames |
  201. | `tween_cel_positions_eased` | Position tween with easing (ease_in/out, smoothstep) |
  202. | `tween_cel_opacity_eased` | Opacity tween with easing |
  203. | `tween_cel_scale_eased` | Scale tween with easing and anchor |
  204. | `oscillate_cel_positions` | Sine-wave motion (bobbing, breathing, hovering) |
  205. | `set_tag` / `delete_tag` | Animation tags with direction (forward/reverse/pingpong) |
  206. | `set_layer_visibility` / `set_layer_opacity` | Layer-level visibility and opacity |
  207. | `set_onion_skin` | Configure onion-skin UI prefs (see `render_onion_skin` for batch use) |
  208. | `get_sprite_info` | Sprite metadata: size, layers, frames, durations, tags |
  209. ### Palette
  210. | Tool | Description |
  211. |------|-------------|
  212. | `get_palette` | Read the palette as hex colors |
  213. | `set_palette` | Set the palette from a list of hex colors |
  214. | `list_palette_presets` | List built-in retro palettes |
  215. | `apply_palette_preset` | Apply a preset: `gameboy`, `pico8`, `c64`, `cga`, `dawnbringer16`, `dawnbringer32`, `grayscale_4`, `monochrome` |
  216. | `generate_color_ramp` | Build a dark→light shading ramp with hue shifting from a base color |
  217. | `quantize_to_palette` | Snap every pixel to the nearest palette color |
  218. | `remap_colors_in_cel_range` | Remap specific colors across a frame range |
  219. | `set_color_mode` | Convert between RGB, grayscale, and indexed |
  220. ### Transform
  221. | Tool | Description |
  222. |------|-------------|
  223. | `flip_layer` | Flip a cel horizontally or vertically |
  224. | `rotate_layer` | Rotate a cel 90/180/270° |
  225. | `resize_canvas` | Scale the sprite to new dimensions |
  226. | `crop_canvas` | Crop to a rectangle |
  227. ### Slices
  228. | Tool | Description |
  229. |------|-------------|
  230. | `create_slice` | Create a named rectangular region |
  231. | `set_slice_center` | Set the 9-patch stretchable center |
  232. | `set_slice_pivot` | Set the pivot point |
  233. | `list_slices` | List all slices with bounds, centers, pivots as JSON |
  234. | `delete_slice` | Delete a slice |
  235. ### Tilemap
  236. | Tool | Description |
  237. |------|-------------|
  238. | `create_tilemap_layer` | Add a tilemap layer with its own tileset and tile grid |
  239. | `draw_on_tile` | Paint pixels into a tileset tile (auto-appends new tiles) |
  240. | `set_tiles` | Place tiles on the map by grid position |
  241. | `get_tile_at` | Read which tile occupies a grid cell |
  242. | `get_tilemap_info` | Tile size, tile count, and map dimensions as JSON |
  243. ### Export & Import
  244. | Tool | Description |
  245. |------|-------------|
  246. | `export_sprite` | Export to PNG, GIF, JPG, ... |
  247. | `export_frame` | Export one frame as PNG with integer upscaling (to look at your work, use `view_sprite`) |
  248. | `export_spritesheet` | Sprite sheet (horizontal/vertical/rows/columns/packed) with optional JSON metadata and per-tag filtering |
  249. | `export_layers` | One PNG per layer |
  250. | `export_tag` | Export an animation tag as GIF or PNG sequence |
  251. | `export_animation` | GIF or PNG sequence of every frame or one tag, scaled, optionally on a solid background — the sprite itself is never changed |
  252. | `import_image_as_layer` | Import a PNG into a layer (references, premade parts) |
  253. | `copy_sprite` | Duplicate the .aseprite file |
  254. ### Inspection
  255. | Tool | Description |
  256. |------|-------------|
  257. | `get_pixel_color` | Read one pixel's RGBA |
  258. | `get_pixels_rect` | Read a rectangle of pixels as JSON |
  259. | `get_composite_pixel` / `get_composite_rect` | Read what is visible (all layers composited) at a pixel or over a rectangle |
  260. | `read_rows` | Read a region as rows of characters plus a legend — the compact format `draw_rows` takes back |
  261. | `get_sprite_info` | Sprite metadata (also listed under Animation) |
  262. ### Analysis & Visual Feedback
  263. Batch-mode equivalents of what a human artist gets from the Aseprite UI.
  264. | Tool | Description |
  265. |------|-------------|
  266. | `view_sprite` | Return an image of the frames straight to the model — zoomed, with pixel grid and coordinate rulers so it can fix exact pixels |
  267. | `render_onion_skin` | Render a frame over translucent ghosts of neighboring frames — check motion continuity without opening Aseprite |
  268. | `compare_frames` | Diff two frames, optionally one layer or region (did the feet move?): changed pixel count, percentage, bounding box |
  269. | `get_bounds` | Bounding box of the drawn pixels per frame, optionally one layer — measure rise and fall, ground line, canvas edges |
  270. | `lint_sprite` | Detached pieces, lone pixels and orphan pixels, with coordinates |
  271. | `get_color_stats` | Color histogram of a frame — catches palette drift and near-duplicate colors |
  272. `view_sprite` is the drawing loop's eyes: it returns the picture as MCP image content, so the model sees its work without exporting a file and opening it, and works in clients that cannot read local files. Pick frames with `"3"`, `"1-4"` or `"1,3,6-8"`, `layer_name` to isolate one layer, and `region="x,y,w,h"` to zoom into a detail with rulers still in sprite coordinates.
  273. ### Quality
  274. | Tool | Description |
  275. |------|-------------|
  276. | `ensure_layers_present` | Create missing cels for layers across a frame range |
  277. | `validate_scene` | Report missing layers/cels as JSON |
  278. | `audit_animation` | Audit frames for overlaps and out-of-range layer activity |
  279. | `animation_sanitize` | Normalize layer order, coverage, and overlaps |
  280. ### Scene
  281. | Tool | Description |
  282. |------|-------------|
  283. | `copy_layers_between_sprites` | Copy layers by name from one .aseprite file to another |
  284. ### Preview & Guide
  285. | Tool | Description |
  286. |------|-------------|
  287. | `start_preview_server` / `stop_preview_server` | Serve exported files over local HTTP |
  288. | `animation_workflow_guide` | How to animate well: key poses, anticipation, squash and stretch, timing (`character`, `idle`, `environment`) |
  289. The server also sends short pixel-art rules as MCP `instructions` when a client connects (silhouette first, one light direction, clean lines, check each pass), so the model gets them without calling anything.
  290. ### Scripting
  291. | Tool | Description |
  292. |------|-------------|
  293. | `run_lua_script` | Execute arbitrary Aseprite Lua ([API docs](https://www.aseprite.org/api/)) in batch mode. The last resort, for what no dedicated tool covers: one script can batch many operations into a single Aseprite launch. Remember to `spr:saveAs(spr.filename)` and `print()` your results. ⚠️ Runs unrestricted code on the host — only pass scripts you trust. |
  294. ## Recommended Workflow for LLMs
  295. 1. **Plan the palette first**: `generate_color_ramp` for each material (skin, armor, blade), or `apply_palette_preset` for a retro look.
  296. 2. **Build in layers**: background / body / equipment / effects, so parts can be animated and edited independently.
  297. 3. **Draw coarse to fine**: silhouette with `draw_rectangle_at` / `draw_ellipse_at` / `fill_area_at`, then refine with `draw_rows`.
  298. 4. **Look at your work**: `view_sprite` after every pass (`region` to zoom in), fix, repeat. Use `get_color_stats` to keep the palette tight and `lint_sprite` to catch stray and detached pixels.
  299. 5. **Shade with intent**: `adjust_hsl` for shadow layers, `apply_dither_gradient` for blends, `outline_cel` for readability.
  300. 6. **Animate with the cel tools**: `propagate_cels`, then `tween_cel_positions_eased` / `oscillate_cel_positions`; verify with `view_sprite`, `compare_frames` and `get_bounds`; export with `export_animation` or `export_tag`.
  301. ## Docker Usage
  302. ### Quick Start
  303. Build and run the Docker image:
  304. ```bash
  305. docker build -t aseprite-mcp:latest .
  306. docker run -it --rm aseprite-mcp:latest
  307. ```
  308. Or use the provided build scripts:
  309. - **Linux/macOS**: `chmod +x build-docker.sh && ./build-docker.sh`
  310. - **Windows**: `.\build-docker.ps1`
  311. ### Using Docker Compose
  312. ```bash
  313. # Production
  314. docker-compose up aseprite-mcp
  315. # Development mode
  316. docker-compose --profile dev up aseprite-mcp-dev
  317. ```
  318. See [DOCKER.md](DOCKER.md) for detailed Docker setup instructions.
  319. ### Optional: Install Aseprite via Steam
  320. To have the container install Aseprite via SteamCMD at startup, provide Steam credentials:
  321. ```powershell
  322. # Create a .env with STEAM_USERNAME/STEAM_PASSWORD (and optional STEAM_GUARD_CODE)
  323. # Then
  324. docker run --rm -i --env-file .env aseprite-mcp:latest
  325. ```
  326. If installed, the binary will be at `/opt/steamapps/common/Aseprite/aseprite` and `ASEPRITE_PATH` will be picked up automatically.
  327. ## Local Installation
  328. ### Prerequisites
  329. - Python 3.13+
  330. - `uv` package manager
  331. - Aseprite (set `ASEPRITE_PATH` in `.env` if it is not on your PATH)
  332. An Aseprite run that takes longer than 60 seconds is stopped and reported as an error. Set `ASEPRITE_TIMEOUT_SECONDS` in `.env` to change that limit.
  333. ### Installation:
  334. ```json
  335. {
  336. "mcpServers": {
  337. "aseprite": {
  338. "command": "/opt/homebrew/bin/uv",
  339. "args": [
  340. "--directory",
  341. "/path/to/repo",
  342. "run",
  343. "-m",
  344. "aseprite_mcp"
  345. ]
  346. }
  347. }
  348. }
  349. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.