diivi/aseprite-mcp

它是什么。 一个 Python MCP 服务器，让 AI 助手（如 Claude）直接驱动像素艺术编辑器 Aseprite。AI 不再描述需求然后由人类点击操作，而是可以自己创建精灵、绘制像素、动画帧、管理图层、应用效果、导出文件，甚至在 Aseprite 内运行原始 Lua 脚本——全部通过 18 个类别中的 123 个命名工具实现。

各部分如何配合。 服务器按任务分组暴露工具——画布设置、绘制、文本、图层、选区、效果、动画、调色板、变换、切片、瓦片地图、导出/导入、检查、分析、质量检查、场景复制、预览服务器和 Lua 逃生舱。README 强调工具集是特意构建的，使 AI 能够生成优质像素艺术，而不仅仅是基本图元：包括带色相偏移的着色渐变、有序抖动、轮廓、带量化的复古调色板预设、洋葱皮渲染、帧差异、边界和用于动画工作的 lint 检查。

你实际能做什么（亮点，全部基于 README）：

绘制 — 像素、线条、矩形、圆形、椭圆、多边形、路径、洪水填充、渐变、等距框，以及一个 ASCII 艺术风格的 draw_rows 工具，通过字符行和颜色图例放置像素；read_rows 以相同的紧凑格式返回像素，用于读取-编辑-绘制循环。
动画 — 帧、cel、标签、带缓动的补间、正弦波运动（bob/breath/hover）、洋葱皮渲染、帧差异，以及用于动画一致性的质量审计。
调色板工作 — 读取/设置调色板，应用复古预设（gameboy、pico8、c64、cga、dawnbringer16、dawnbringer32、grayscale_4、monochrome），生成着色渐变，量化到最近的调色板颜色。
效果 — 轮廓、颜色替换、HSL 调整、抖动渐变/图案，以及原生 Aseprite 滤镜（轮廓、色相/饱和度、亮度/对比度、反相、卷积矩阵如模糊/锐化/边缘/浮雕）。
导出与导入 — PNG/GIF/JPG、带 JSON 元数据的精灵表、按图层或按标签导出、动画作为 GIF 或 PNG 序列、将 PNG 作为图层导入、复制精灵文件。
分析与反馈 — view_sprite 将帧的图像返回给模型本身（缩放、带像素网格和坐标标尺），因此 AI 无需导出文件并打开即可看到自己的作品。还有洋葱皮渲染、帧差异、边界框、精灵 lint 器（检测分离/孤立像素）和颜色直方图以捕捉调色板漂移。
文本 — Aseprite 的 Lua API 没有文本绘制功能，因此服务器自行栅格化字形。两种字体后端：位图精灵表字体（适合像素艺术，整数缩放）和 TrueType 字体，除非请求，否则无抗锯齿渲染。measure_text 返回与 draw_text 相同的度量，因此 AI 无需重绘即可居中标签。
脚本 — run_lua_script 在批处理模式下执行任意 Aseprite Lua，作为最后手段处理任何未覆盖的内容。README 警告：它在主机上运行不受限制的代码，因此只传递你信任的脚本。

README 给 AI 模型的推荐工作流程：

先规划调色板（颜色渐变或复古预设）。
分层构建（背景/身体/装备/效果），以便各部分独立动画。
从粗到细绘制——先画轮廓，然后用 draw_rows 细化。
每次操作后用 view_sprite 查看你的作品；使用 get_color_stats 和 lint_sprite 发现问题。
刻意着色——用 adjust_hsl 处理阴影，用 apply_dither_gradient 处理混合，用 outline_cel 提高可读性。
使用 cel 工具动画——propagate_cels，然后带缓动的补间。

README 中展示的示例输出（全部由 AI 模型生成，展示工具集）：

一个 128×128、16 帧的等距卧室黄昏场景，一个女孩在做作业，一只猫在书架上，以 lofi 风格循环动画。
一个 48×48 的剑士基准（来自 Lj Miranda 的“Draw Me a Swordsman”文章，该文章启发了扩展工具集）：Fable 5 绘制了 4 帧斩击；Opus 5.5 批评了精灵并重新绘制了 8 帧斩击。
一个 32×32 的绿色史莱姆，以及一个 43 帧的弹跳动画，带有挤压和拉伸。
一个 80×58、15 帧的战斗场景，剑士斩击史莱姆——它闪红、失去生命值、弹出伤害数字。

相关项目： Aseprite Live — 在浏览器中实时观看 AI 代理在 Aseprite 中绘制。

简而言之： 这是一座桥梁，将 Aseprite 变成 AI 助手完全可控的绘图表面——配备人类艺术家会使用的分析和反馈工具（洋葱皮、帧差异、lint、直方图），使 AI 能够迭代改进自己的像素艺术。