aseprite-mcp

MCP运维云端

提供方 Vollkorn-Games

运维云端 Streamable HTTP 会话登录 社区 / 第三方 Claude DesktopClaudeCursorCline
查看接入方式

An MCP server that equips AI assistants with Aseprite pixel art editing capabilities, enabling sprite creation, pixel drawing, layer/frame/palette management, animation, and game asset export.

一句话选型结论

按资料字段整理

aseprite-mcp 属于运维云端类 MCP 服务器,Streamable HTTP,会话登录,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式Streamable HTTP 鉴权会话登录 部署方式远程部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Blend Deployment Pixel Art Sprite TypeScript Animation Layer Management Palette MCP Server AI-Assisted Creation Game Asset Export

支持客户端

适用场景

Blend DeploymentPixel ArtSprite

安装与配置

Streamable HTTP 会话登录
新一代远程传输,替代 SSE
node /path/to/aseprite-mcp/build/index.js

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
aseprite-mcp当前 未标注 Streamable HTTP 远程部署 有 2026-09-03
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Vollkorn-Games上游标注的维护方 Vollkorn-Games
分类运维云端本站按上游分类展示
连接方式Streamable HTTP新一代远程传输,替代 SSE
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · node本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-09-03上游最后核验时间

详细介绍

11.4 KB
来自项目仓库与上游目录的原文,未做删改

aseprite-mcp

MCP server for the Aseprite pixel art editor. Enables AI assistants to create sprites, draw pixel art, manage layers/frames/palettes, create animations, and export assets through the Model Context Protocol.

How It Works```

AI Assistant ←→ MCP Server (Node.js) ←→ Aseprite (batch mode + Lua scripting)


The server spawns Aseprite in batch mode (`-b`) with Lua scripts that perform operations and return JSON results via stdout.

### Built for vision models

The server is designed so a model can _see_ and _iterate_ on its own art:

- **`render_sprite`** returns an upscaled, pixel-crisp PNG as MCP image content (single frame or an all-frames strip) so the model can check silhouettes, contrast and animation flow. `showGrid` overlays pixel boundaries, `region` zooms in on a detail, and `outputPath` keeps the render for before/after comparison.
- **`draw_grid`** paints a whole region from rows of characters plus a legend, the natural way to compose a sprite in one call.
- **`get_canvas`** returns the same rows + legend format, so read → edit → write round-trips cleanly.
- Server instructions describe the recommended create → draw → look → refine loop and pixel-art craft guidelines.

## Quickstart```bash
git clone https://github.com/Vollkorn-Games/aseprite-mcp.git
cd aseprite-mcp
pnpm install
pnpm build

Installation

Claude Code```bash

claude mcp add aseprite-mcp -- node /path/to/aseprite-mcp/build/index.js


### Claude Desktop / Cline / Cursor

Add to your MCP configuration:```json
{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "node",
      "args": ["/path/to/aseprite-mcp/build/index.js"]
    }
  }
}

Aseprite is auto-detected from common install locations (Steam, /usr/bin, /Applications, etc.). Set ASEPRITE_PATH only if auto-detection fails.

Streamable HTTP (stateless)

The server also speaks the MCP Streamable HTTP transport (spec 2025-11-25) in stateless mode: every request gets a fresh server instance, no Mcp-Session-Id is issued, and requests can be load-balanced across processes.```bash
MCP_TRANSPORT=http MCP_PORT=3000 node /path/to/aseprite-mcp/build/index.js

→ http://127.0.0.1:3000/mcp

``````bash
claude mcp add --transport http aseprite-mcp http://127.0.0.1:3000/mcp


The server binds to `127.0.0.1` by default. Set `MCP_HOST=0.0.0.0` to expose it on the network — put it behind an authenticating reverse proxy if you do, as the server has no built-in auth.

## Requirements

- **Node.js** >= 18.0.0
- **Aseprite** >= 1.2.10 (with Lua scripting support)
- **pnpm** (package manager)

## Environment Variables

| Variable            | Description                                             |
| ------------------- | ------------------------------------------------------- |
| `ASEPRITE_PATH`     | Path to the Aseprite executable (auto-detected)         |
| `DEBUG`             | Set to `true` for verbose logging                       |
| `MCP_TOOLSETS`      | Comma-separated list of tool categories to expose       |
| `MCP_EXCLUDE_TOOLS` | Comma-separated list of tool names to exclude           |
| `MCP_READ_ONLY`     | Set to `true` to expose only read-only tools            |
| `MCP_TRANSPORT`     | `stdio` (default) or `http` (stateless Streamable HTTP) |
| `MCP_PORT`          | HTTP port (default `3000`, http transport only)         |
| `MCP_HOST`          | HTTP bind address (default `127.0.0.1`)                 |
| `MCP_PATH`          | HTTP endpoint path (default `/mcp`)                     |

## 68 Tools Across 14 Categories

### Sprite Management (5 tools)

| Tool              | Description                                           |
| ----------------- | ----------------------------------------------------- |
| `create_sprite`   | Create a new sprite with width, height, color mode    |
| `open_sprite`     | Open an existing sprite file and return metadata      |
| `get_sprite_info` | Get detailed metadata (layers, frames, tags, palette) |
| `save_sprite`     | Save sprite to file                                   |
| `resize_sprite`   | Resize sprite dimensions                              |

### Layer Operations (5 tools)

| Tool                   | Description                               |
| ---------------------- | ----------------------------------------- |
| `add_layer`            | Add a new layer (normal or group)         |
| `remove_layer`         | Remove a layer by name or index           |
| `set_layer_properties` | Set name, opacity, blend mode, visibility |
| `list_layers`          | List all layers with metadata             |
| `flatten_layers`       | Flatten all layers into one               |

### Frame & Animation (8 tools)

| Tool                  | Description                            |
| --------------------- | -------------------------------------- |
| `add_frame`           | Add new frame (empty or duplicate)     |
| `remove_frame`        | Remove frame by number                 |
| `set_frame_duration`  | Set frame duration in seconds          |
| `list_frames`         | List all frames with durations         |
| `reorder_frames`      | Reverse frame order within a range     |
| `duplicate_frame`     | Clone a frame with all cel content     |
| `add_frames`          | Bulk add multiple empty frames at once |
| `set_frame_durations` | Set durations for multiple frames      |

### Drawing Operations (15 tools)

| Tool            | Description                                    |
| --------------- | ---------------------------------------------- |
| `draw_pixel`    | Set a single pixel color                       |
| `draw_pixels`   | Set multiple pixels at once (batch)            |
| `erase_pixels`  | Erase points and/or a rectangle to transparent |
| `draw_line`     | Draw line between two points                   |
| `draw_rect`     | Draw rectangle (filled or outline)             |
| `draw_ellipse`  | Draw ellipse (filled or outline)               |
| `flood_fill`    | Flood fill from a point with a color           |
| `draw_image`    | Paste an external PNG onto a layer             |
| `draw_circle`   | Draw circle (filled or outline)                |
| `replace_color` | Replace all pixels of one color with another   |
| `outline`       | Add outline around non-transparent pixels      |
| `get_pixels`    | Read pixel colors from a canvas region         |
| `draw_polygon`  | Draw polygon (filled or outline) from points   |
| `get_canvas`    | Dump full canvas as 2D hex color grid          |
| `draw_grid`     | Paint a region from a character grid + legend  |

### Palette Management (5 tools)

| Tool                | Description                      |
| ------------------- | -------------------------------- |
| `get_palette`       | Get all palette colors           |
| `set_palette_color` | Set color at palette index       |
| `load_palette`      | Load palette from file           |
| `create_palette`    | Create palette from color list   |
| `resize_palette`    | Change number of palette entries |

### Selection Operations (4 tools)

| Tool               | Description                  |
| ------------------ | ---------------------------- |
| `select_rect`      | Create rectangular selection |
| `select_all`       | Select entire canvas         |
| `deselect`         | Clear selection              |
| `invert_selection` | Invert current selection     |

### Transform Operations (4 tools)

| Tool            | Description                               |
| --------------- | ----------------------------------------- |
| `flip_sprite`   | Flip horizontal/vertical                  |
| `rotate_sprite` | Rotate by 90/180/270 degrees              |
| `crop_sprite`   | Crop to rectangle or auto-crop to content |
| `trim_sprite`   | Auto-trim transparent borders             |

### Tag Operations (4 tools)

| Tool                 | Description                                     |
| -------------------- | ----------------------------------------------- |
| `create_tag`         | Create animation tag over frame range           |
| `remove_tag`         | Remove tag by name                              |
| `list_tags`          | List all tags with frame ranges                 |
| `set_tag_properties` | Modify tag name, color, direction, repeat count |

### Export Operations (4 tools)

| Tool                 | Description                              |
| -------------------- | ---------------------------------------- |
| `export_png`         | Export sprite/frames as PNG              |
| `export_spritesheet` | Generate sprite sheet with JSON metadata |
| `export_gif`         | Export as animated GIF                   |
| `render_sprite`      | Return an upscaled PNG as image content  |

### Cel Operations (4 tools)

| Tool           | Description                            |
| -------------- | -------------------------------------- |
| `clear_cel`    | Clear cel content                      |
| `get_cel_info` | Get cel position, opacity, bounds      |
| `copy_cel`     | Copy cel content between frames/layers |
| `move_cel`     | Move/translate cel content by offset   |

### Tileset & Tilemap (3 tools)

| Tool                   | Description                              |
| ---------------------- | ---------------------------------------- |
| `create_tilemap_layer` | Create a tilemap layer with tileset grid |
| `set_tile`             | Place a tile at grid coordinates         |
| `get_tileset_info`     | Get tileset metadata and tile count      |

### Batch Operations (3 tools)

| Tool                 | Description                                  |
| -------------------- | -------------------------------------------- |
| `batch_export`       | Export frames/layers as individual PNGs      |
| `batch_resize`       | Resize multiple sprites by scale factor      |
| `import_spritesheet` | Import spritesheet PNG and split into frames |

### Color & Analysis (4 tools)

| Tool               | Description                                |
| ------------------ | ------------------------------------------ |
| `analyze_colors`   | Count unique colors, find most/least used  |
| `quantize_colors`  | Reduce color count to target palette size  |
| `generate_palette` | Auto-generate palette from sprite colors   |
| `color_ramp`       | Generate color gradient between two colors |

## Tool Filtering

Filter which tools are exposed using environment variables:```bash
# Only expose sprite and drawing tools
MCP_TOOLSETS=sprite,drawing

# Exclude specific tools
MCP_EXCLUDE_TOOLS=flood_fill,export_gif

# Read-only mode (only get_*, list_*, open_* tools)
MCP_READ_ONLY=true

Development```bash

pnpm install # Install dependencies
pnpm build # Compile TypeScript + copy Lua scripts
pnpm test # Run all tests (requires Aseprite)
pnpm test:unit # Run unit tests only
pnpm lint # ESLint
pnpm format:check # Prettier check
pnpm typecheck # TypeScript check
pnpm inspector # Open MCP Inspector
pnpm watch # Auto-rebuild on changes


## Troubleshooting

### Aseprite not found

The server auto-detects Aseprite from common locations including Steam, `/usr/bin`, `/usr/local/bin`, `/Applications`, and standard Windows paths. If auto-detection fails, set the `ASEPRITE_PATH` environment variable:```bash
# Linux
export ASEPRITE_PATH=/usr/bin/aseprite

# macOS
export ASEPRITE_PATH=/Applications/Aseprite.app/Contents/MacOS/aseprite

# Windows
set ASEPRITE_PATH=C:\Program Files\Aseprite\Aseprite.exe

Debug output

Set DEBUG=true to see detailed operation logs in stderr.

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
aseprite-mcp 怎么安装?

在客户端按下面的安装命令接入:node /path/to/aseprite-mcp/build/index.js。装完在客户端配置里引用同一个包或端点。

aseprite-mcp 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是Streamable HTTP,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

aseprite-mcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

aseprite-mcp 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

aseprite-mcp 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

aseprite-mcp 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、Pixel Art、Sprite、TypeScript、Animation、Layer Management。具体工具清单以官方文档为准。

aseprite-mcp 需要什么运行环境?

运行时为 node;属于远程端点,不需要在本地装运行时。

aseprite-mcp 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为Streamable HTTP。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-09-03。