Aseprite Live

claude mcp add aseprite-live -- uvx aseprite-live-mcp

{
  "mcpServers": {
    "aseprite-live": {
      "command": "uvx",
      "args": ["aseprite-live-mcp"],
      "env": {
        "ASEPRITE_MCP_BACKEND": "headless",           // or "live" — see below
        "ASEPRITE_PATH": "C:/Program Files/Aseprite/Aseprite.exe"
      }
    }
  }
}

如果省略 ASEPRITE_PATH，系统会自动检测常见安装位置（Steam 和独立安装版）。

git clone https://github.com/oaktreegames/aseprite-live-mcp
cd aseprite-live-mcp
pip install -e .

• status — 报告后端运行状况、本服务的版本，以及是否有更新版本。
• get_sprite_info — 获取当前精灵的尺寸、颜色模式，以及图层 / 帧 / 标签列表。
• get_pixel — 读取 (x, y) 处合成后的单个像素（所有图层），格式为 #rrggbbaa。
• set_sprite_metadata — 为精灵添加带类型的键值元数据（Aseprite 的 Properties 系统——直接存储在 .aseprite 文件中）。
• get_sprite_metadata — 读取精灵的带类型键值元数据（Properties）。
• get_pixels — 以 #rrggbbaa 字符串网格的形式读取合成后的像素区域——为 AI 提供反馈循环，让它了解“当前画布是什么样”。

• create_sprite — 创建新精灵。
• expand_canvas — 按每一侧扩展（或使用负值缩小）画布，但不缩放内容——现有像素相对于旧原点的位置保持不变。
• import_spritesheet — 将精灵表 PNG 切分为动画帧：按给定帧尺寸逐行读取单元格，放入新的 “imported” 图层，并根据需要添加帧。

• add_layer — 在图层堆栈顶部添加一个新的空图层（可选择命名）。
• add_group — 添加图层组。
• move_layer_to_group — 将图层移入图层组。
• list_layers — 列出完整图层树，按堆栈从顶到底排序：名称、路径、类型（image/group/tilemap）、可见性和不透明度；包括嵌套在组中的图层（get_sprite_info 仅列出顶层图层）。
• delete_layer — 删除指定名称的图层。
• rename_layer — 重命名图层。
• set_layer_visibility — 显示或隐藏图层。
• set_layer_opacity — 设置图层的不透明度（0-255）。
• flatten_sprite — 将所有图层合并为一个图层。
• set_layer_blend_mode — 设置图层的混合模式。
• duplicate_layer — 在原图层上方复制该图层（包括其 cel）。
• merge_layer_down — 将图层合并到正下方的图层中。
• move_layer — 调整图层在堆栈中的顺序。
• import_image_as_layer — 将外部图像文件（PNG 等）以 (x, y) 为位置导入为新图层——用于概念美术导入的参考/描摹图层。

• add_frame — 在末尾追加一个新的空帧。
• duplicate_frame — 复制 number 帧（从 1 开始计数）。
• delete_frame — 删除 number 帧（从 1 开始计数）。
• set_frame_duration — 设置 number 帧的持续时间（毫秒）。
• add_frames — 在一个撤销步骤中追加 count 个空帧。
• set_frame_durations — 将 [from_frame..to_frame] 中的每一帧设为 ms 毫秒。
• reverse_frames — 反转帧顺序（包括所有图层上的 cel 及其持续时间）——默认处理整个精灵，也可处理包含起止帧的 [from_frame..to_frame] 范围。
• set_onion_skin — 配置编辑器的洋葱皮视图：开启/关闭、两个方向上的残影数量，以及残影是否限制在当前标签内。

• clear_cel — 清空指定图层和帧上的 cel（设为透明）。
• set_cel_position — 将 cel 的左上角原点移动到 (x, y)。
• set_cel_opacity — 设置 cel 的不透明度（0-255）。

• get_palette — 以 #rrggbbaa 十六进制字符串的形式返回当前精灵的调色板。
• set_palette_color — 将调色板的 index 项设为 color（#rrggbb 或 #rrggbbaa）。
• add_palette_color — 将 color 追加到调色板，并返回其新索引。
• set_palette — 使用 colors（#rrggbb/#rrggbbaa 列表）替换整个调色板。
• apply_preset_palette — 将调色板替换为内置预设：gameboy | pico8 | cga。
• generate_color_ramp — 根据 base_color 生成从深到浅的明暗色阶，并按顺序追加到调色板末尾，供 palette_ramp_walk 使用。
• extract_palette_from_image — 从外部图像文件提取调色板（中位数切分），并默认将其设为当前精灵的调色板——这是从概念设计到锁定调色板的步骤。
• sort_palette — 按 luminance（默认）、hue 或 saturation 对调色板色块重新排序。
• palette_from_sprite — 根据精灵的实际像素生成调色板（Aseprite 的颜色量化）——与 quantize_to_palette 的作用相反。
• load_palette — 从调色板文件（.gpl、.pal、.ase、.png 色带——Aseprite 能读取的任何格式）替换精灵的调色板。
• save_palette — 将精灵的调色板写入文件（.gpl、.pal、.png——由扩展名决定）。
• apply_bundled_palette — 按资源 ID 应用 Aseprite 自带扩展调色板之一，例如 DB16、DB32、ARQ4、EDG16（是否可用取决于已安装的调色板扩展）。

• replace_color — 在当前 cel 中，将所有匹配 from_color 的像素（在 tolerance 范围内，该值表示 0-255 的 RGB 距离）替换为 to_color；除非 to_color 自带 Alpha 值，否则保留每个像素原有的 Alpha 值。
• quantize_to_palette — 将当前 cel 中每个不透明像素转换为精灵调色板中与之最接近的颜色（保留 Alpha 值）——在导入或着色后保持调色板规范。
• adjust_hsl — 在 HSL 空间调整当前 cel 的颜色：hue_shift 为角度（-360..360），saturation 为倍率（1.0 表示不变），lightness 为增量（-1..1）。
• get_color_stats — 返回合成精灵的颜色直方图：不重复的不透明颜色数量、不透明像素总数，以及使用频率最高的 top 种颜色及其计数——用于美术 QA 流程中的调色板漂移检查。

• apply_shading — 受调色板约束的着色：朝光源方向提亮，背光方向变暗，并将每个像素映射为最接近的调色板颜色。
• palette_ramp_walk — 按光照方向沿已排序的调色板向更亮或更暗的方向移动 ±N 个索引来着色，而不是映射到亮度最接近的颜色——这样可以遵循手动排序的明暗色阶。

• paint_with_stamp — 在 points 中的每个 [x, y] 位置盖上图像印章（点表示印章中心）。

• draw_iso_box — 绘制一个 2:1 等距盒体。
• draw_iso_cylinder — 绘制一个垂直等距圆柱体（储罐／筒仓／烟囱）：包含顶部椭圆、阴影主体和前沿，并根据 color 自动添加阴影。
• fill_polygon — 根据 points（按顺序排列的 [x, y] 对列表）对任意多边形进行扫描线填充。
• iso_recessed_panel — 在等距表面绘制一个内凹的对接插座／端口——以明亮的受光边缘框住暗色内凹部分。

• select_rectangle — 设置矩形选区。
• select_all — 选择整个画布。
• deselect — 清除当前选区。
• select_ellipse — 选择给定矩形内切的椭圆。
• select_by_color — 选择所有与 color 匹配的像素（合成后的颜色，各通道容差为 0-255）——全局魔棒。
• invert_selection — 根据画布边界反转当前选区。
• get_selection — 报告是否存在选区及其边界矩形。
• erase_area — 将像素擦除为透明。

• flip_sprite — 水平或垂直翻转整个精灵图。
• resize_sprite — 将整个精灵图缩放到新的像素尺寸。
• crop_sprite — 将精灵图裁剪到给定矩形。
• rotate_sprite — 将整个精灵图顺时针旋转 90、180 或 270 度（无损）。
• autocrop_sprite — 修剪透明边框：将画布缩小至所有图层和帧中可见内容的并集（Sprite > Trim）。
• set_color_mode — 在 rgb | gray | indexed 色彩模式之间转换精灵图。

• create_slice — 在给定矩形处创建一个命名切片（图集区域）。
• set_slice_pivot — 设置切片的轴心点，单位为像素，相对于切片左上角。
• set_slice_center — 设置切片的 9-patch 可拉伸中心矩形（相对于切片）。
• list_slices — 列出所有切片及其边界、轴心点和 9-patch 中心。
• delete_slice — 删除指定名称的切片。

• create_tag — 创建名为 name 的动画标签，范围为第 from_frame..to_frame 帧（从 1 开始）。
• delete_tag — 删除名为 name 的动画标签。
• list_tags — 列出动画标签及其帧范围。
• rename_tag — 将动画标签 old_name 重命名为 new_name。
• set_tag_color — 设置标签 name 的时间轴标签颜色（#rrggbb 或 #rrggbbaa）。
• set_tag_range — 将标签 name 的范围设为第 from_frame..to_frame 帧（从 1 开始，包含首尾；根据精灵图的帧数进行验证）。
• set_tag_direction — 设置标签 name 的播放方向：forward | reverse | pingpong | pingpong_reverse。

• tween_frames — 在 from_frame 和 to_frame 之间插入 count 个中间帧，对 cel 的位置进行插值（对起始 cel 的图像进行运动补间）。
• tween_cel_opacity — 在 [from_frame..to_frame] 范围内淡入或淡出图层的 cels：使用所选缓动方式，将不透明度从 from_opacity 插值到 to_opacity（0-255）。
• smear_frame — 添加一个运动模糊帧，混合 from_frame 和 to_frame：重叠像素取平均值，仅出现在单帧中的区域以半透明度残影呈现——这是像素内容的拖影效果。
• frame_diff — 对两个合成帧进行逐像素精确比较：返回变化像素数量及比例、变化边界框，以及两帧是否相同。
• render_onion_composite — 写入 frame 的 PNG，将最多 prev 个较早帧以红色残影显示，将最多 next 个较晚帧以蓝色残影显示（遵循 Aseprite 的洋葱皮惯例），并采用指定的残影 opacity——以便在一张图像中查看运动轨迹。

• export_sprite — 将当前活动精灵导出到文件；格式由 out_path 扩展名决定（.png、.gif 等）。
• export_spritesheet — 将所有帧打包为一张精灵图（可选将 JSON 图集写入 data_path）。
• export_layers — 将每个图像图层（递归处理组）分别导出为 out_dir 中的 PNG，文件名为 <sanitized-layer-name>.png。
• export_tags — 将每个动画标签的帧范围分别导出为 out_dir 中的文件：动画 <tag-name>.gif（format="gif"，默认）或水平 <tag-name>.png 条带（format="png"）。

• export_unity_sprite — 导出水平精灵图，并在其旁写入 Unity .meta，预先切分为命名的 Multiple 模式精灵（每帧一个）——一步完成，无需手动使用 Sprite Editor。
• export_unity_slices — 将精灵导出为单张 PNG，并写入包含多个 Multiple 模式精灵的 Unity .meta（每个命名切片对应一个精灵），每个精灵均保留该切片的轴心点——这样，带切片布局的图集导入 Unity 后即可完成切片并设置轴心点。

• measure_padding — 测量内容周围透明的“贴纸”边距：内容边界框、各侧边距（左/右/上/下）、填充率和不透明颜色种类数。
• qa_sweep — 根据项目规范检查当前活动精灵，并返回每项检查的通过/失败结果。

• batch_export — 将 folder 中每个 .aseprite 的第一帧导出为图像，可选按 scale 整数倍放大。
• batch_resize — 调整 folder 中每个 .aseprite 的大小（第一帧，使用最近邻插值），并将图像写入 out_dir。
• batch_apply_palette — 将 folder 中每个 .aseprite 的颜色锁定到调色板：将每个精灵（第一帧，保留 alpha）映射到调色板，并将图像导出到 out_dir。

• get_editor_state — 仅限实时编辑器：获取当前缩放、滚动位置，以及鼠标所在的精灵图像素位置，让 Agent 知道艺术家正在查看什么。
• set_editor_view — 仅限实时编辑器：设置视口缩放（1.0 = 100%）和／或滚动位置，例如，放大即将编辑的区域，让艺术家可以观看。
• set_symmetry — 仅限实时编辑器：设置镜像绘制对称模式；mode 可以是 none、horizontal（沿垂直轴镜像）、vertical 或 both；还可以选择放置对称轴线。
• ask_point — 仅限实时编辑器：请求艺术家在画布上单击一个点（轴心、锚点、绘制原点）。
• get_asked_point — 轮询 ask_point 的结果：等待时 done 为 false，之后返回单击位置的 x／y（如果艺术家按下 Esc，则返回 cancelled）。
• cancel_ask_point — 撤销待处理的 ask_point 请求（例如，艺术家暂时离开了，你要继续进行其他操作）。
• show_choice_dialog — 仅限实时编辑器：在 Aseprite 中弹出一个小对话框，显示消息并提供最多 4 个选项按钮（例如，批准／重做）。
• get_dialog_choice — 轮询 show_choice_dialog 的结果：对话框打开时 done 为 false，之后返回所选按钮的文本。
• watch_changes — 仅限实时编辑器：开始统计艺术家对当前精灵图所做的编辑（通过 Sprite.events）。
• get_watched_changes — 轮询由 watch_changes 开始的更改计数器（reset=True 会在读取后将其清零）。
• stop_watching_changes — 移除 watch_changes 监听器。

• run_lua — 在 Aseprite 中运行任意 Lua 并返回结果（高级逃生通道，相当于在本地执行代码）。