MA

malloythedev/aseprite-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

24 stars 1 forks 质量 77 趋势 31MIT

一个模型上下文协议服务器,无头驱动Aseprite并测量它绘制的内容:156个工具用于绘制、着色和像素艺术动画,结果显示每个调用的功能。

概览

      绘制、着色、动画、计时并测量:完全通过MCP工具调用完成,无需手动像素推入。这里的每张图片均由本仓库中的脚本重新生成。 一个庞大的模型上下文协议服务器,允许AI代理(Claude Code、Claude Desktop或任何MCP客户端):绘制像素艺术,制作动画,管理图层/帧/标签/调色板,并导出为PNG/GIF/精灵图集,所有这些都是无头的。 📖 docs/TOOLS.md:每个工具及其参数。 它通过生成并通过 Aseprite 的批处理模式(aseprite -b --script 等)运行这些文件,同时通过 Aseprite CLI 进行导出。每次操作都会打开一个真实的 .aseprite 文件,编辑并保存,这样你的文件在 Aseprite 图形界面中依然可以完全编辑。

概述(AI 翻译)

 

 

 

绘制、着色、动画、计时和测量:全部通过MCP 工具调用,无需手动像素推入。这里的每张图片 由本仓库中的脚本重新生成。

一个广泛的模型上下文协议服务器,允许 AI代理(Claude Code、Claude Desktop,或任何MCP客户端)创建和编辑 Aseprite精灵:绘制像素艺术,制作动画, 管理图层/帧/标签/调色板,并导出为PNG/GIF/精灵图集,全部无头处理。

📖 完整工具参考: docs/TOOLS.md:每个工具及其参数。

它通过生成Lua脚本,并通过Aseprite的批处理模式运行 ([aseprite -b --script ...),以及用于导出的Aseprite命令行。每个操作都会开启一个 真实的.aseprite文件,编辑并保存,确保你的文件在 Aseprite 图形界面。

  • 165个工具覆盖精灵的每个部分:绘制(像素完美且抗锯齿), 自定义画笔和对称性,斜坡感知阴影,选择范围用于后续编辑, 调色板、图层、帧、赛璐璐、动画标签、切片和9-patch、特效、文本, 瓦片地图、变换和导出(每层、每个标签、精灵图集、GIF、洋葱皮肤,

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Aseprite MCP

 

 

 

Drawn, shaded, animated, timed and then measured: entirely through MCP tool calls, with no manual pixel-pushing. Every image here is regenerated by a script in this repository.

An extensive Model Context Protocol server that lets an AI agent (Claude Code, Claude Desktop, or any MCP client) create and edit Aseprite sprites: draw pixel art, build animations, manage layers/frames/tags/palettes, and export to PNG/GIF/sprite sheets, all headlessly.

📖 Full tool reference: docs/TOOLS.md: every tool with its parameters.

It works by generating Lua scripts and running them through Aseprite’s batch mode (aseprite -b --script ...), plus the Aseprite CLI for exports. Every operation opens a real .aseprite file, edits it, and saves, so your files stay fully editable in the Aseprite GUI.

  • 165 tools across every part of a sprite: drawing (pixel-perfect and anti-aliased), custom brushes and symmetry, ramp-aware shading, selections that scope later edits, palettes, layers, frames, cels, animation tags, slices and 9-patch, effects, text, tilemaps, transforms, and export (per-layer, per-tag, sprite sheets, GIF, onion-skin, Godot, Minecraft). See the tool catalogue or the full reference.
  • Whole assets in one call - workflow tools scaffold and validate a character, an icon set, a tileset or an eight-direction walk template, and a batch op-runner
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "aseprite": { "command": "uv", "args": ["--directory", "C:\\path\\to\\aseprite-mcp", "run", "aseprite-mcp"], "env": { "ASEPRITE_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\Aseprite\\Aseprite.exe", "ASEPRITE_MCP_WORKSPACE": "C:\\path\\to\\aseprite-mcp\\workspace" } } } }