用途

aseprite-mcp 是一个 Python MCP 服务器，让 AI 助手能够全面控制 Aseprite，用于创建像素画和动画精灵。它把 Aseprite 的能力暴露为 MCP 工具，使大语言模型可以绘图、检查自己的作品并导出结果。

主要能力

服务器包含 104 个工具，分布在 17 个类别中，覆盖画布、绘制、图层、动画、调色板、特效、切片、瓦片地图、导出、视觉反馈/分析工具，以及一个原生 Lua 逃生通道。

工具集的设计目标是让 LLM 拥有产出良好像素画所需的一切，而不仅仅是基础图元，包括：带色相偏移的明暗渐变、有序抖动、描边、带量化的复古调色板预设、洋葱皮渲染，以及用于动画工作的帧对比（frame diffing）。

所有 _at 变体都针对特定的图层/帧，并可按需创建 cel。坐标是精灵全局坐标。

文本绘制

Aseprite 的 Lua API 没有文本绘制功能，因此字形在服务器端进行光栅化，然后合成到精灵中。支持两种字体后端：位图精灵表字体（像素画的正确选择——字形本身已经是像素，尺寸按整数倍缩放）和 TrueType .ttf/.otf 文件（除非要求，否则渲染时不使用抗锯齿）。

字体在 ~/.aseprite-mcp/fonts 中发现：位图字体是一个包含 font.json 及其表 PNG 的目录；TrueType 字体就是字体文件本身。已安装的系统字体也会被列出。font 也接受直接路径。

当布局依赖文本时，应先调用 measure_text：它返回与 draw_text 将使用的相同度量，因此标签可以一次居中或一次性确定底板尺寸。

锚点包括 topleft/top/topright、left/center/right、bottomleft/bottom/bottomright，以及 baselineleft/baseline/baselineright，用于将多个标签固定在同一基线上。描边和阴影会扩大图章，但从不移动字形。

每个字表携带自己的 ascent，因此不同单元尺寸的字表仍然共享一条基线——这就是紧凑的 ASCII 字表和更高的重音字表如何组合成一次运行。当字表有边距时，origin 会移动单元格网格；ink_rule: "dark" 读取使用不透明白色背景来界定可变宽度字形框的字表；advance: "box" 从框而不是墨水获取步进。overrides 用手绘行替换单个字形，这在字表提供的字形偏离中心或太高而无法坐在线上时很有用。

选区与区域

像素画工具箱：干净的描边、遵循调色板的混合，以及明暗变体。

导出与导入

分析与视觉反馈

人类艺术家从 Aseprite UI 获得的功能的批处理模式等效项。

预览与参考

给 LLM 的推荐工作流

先规划调色板：为每种材质（皮肤、盔甲、刀片）使用 generate_color_ramp，或使用 apply_palette_preset 获得复古外观。
分层构建：背景/身体/装备/特效，这样各部分可以独立动画和编辑。
从粗到细绘制：用 draw_rectangle_at/draw_ellipse_at/fill_area_at 画轮廓，然后用 draw_pixels_at 细化。
查看你的作品：以 8 倍导出 export_frame，检查、修复、重复。使用 get_color_stats 保持调色板紧凑。
有意图地做明暗：用 adjust_hsl 处理阴影层，用 apply_dither_gradient 做混合，用 outline_cel 提高可读性。
用 cel 工具做动画：propagate_cels，然后 tween_cel_positions_eased/oscillate_cel_positions；用 render_onion_skin 和 compare_frames 验证；用 export_tag 导出。

使用方式

构建并运行 Docker 镜像

或使用提供的构建脚本：

Linux/macOS：chmod +x build-docker.sh && ./build-docker.sh
Windows：.\build-docker.ps1

使用 Docker Compose

详细 Docker 设置说明见 DOCKER.md。

可选：通过 Steam 安装 Aseprite

要让容器在启动时通过 SteamCMD 安装 Aseprite，请提供 Steam 凭据：

如果已安装，二进制文件将位于 /opt/steamapps/common/Aseprite/aseprite，ASEPRITE_PATH 将被自动获取。

本地安装

需要 uv 包管理器、Aseprite（如果不在 PATH 中，请在 .env 中设置 ASEPRITE_PATH），以及用于与 Aseprite API 交互的 MCP 服务器。

适用场景

适合让 AI 助手通过 MCP 工具绘制像素画、制作动画精灵，并利用视觉反馈工具进行自我检查与导出。项目中的示例（一个剑士）由 Claude Fable 5 全程通过该服务器的 MCP 工具创建——绘制、用缩放后的 export_frame 预览和 render_onion_skin 检查自己的工作，然后导出。

限制

关于收费、价格、平台、效果或使用步骤等未在资料中明确说明的信息，暂未提供。

aseprite-mcp

工具介绍

用途