这个 MCP 能做什么
它给你的助手提供 9 个工具。助手把你的描述生成角色图(或者给你自己画的角色做动画),一次加一个动作,再把结果打包成游戏引擎能直接读的文件:
sheet.png:透明背景、按网格排好的全部帧sheet.json:TexturePacker 格式的 JSON,包含每帧位置和动画,Phaser 等大多数引擎都能读animation.tres:Godot 4 的 SpriteFrames 资源,直接给 AnimatedSprite2D 用export.json:帧尺寸、帧数和帧率;需要的话还有单帧图和预览 GIF

怎么用
1. 一句话安装
把上面的话发给助手。它会读取 install.txt,装好教它使用流程的说明(skill),并添加 MCP 服务,配置里不放密钥。
2. 给它一个有额度的密钥
在账户页创建密钥,勾选“生成角色和动作”,设好每天和总共最多花多少积分。然后在你自己的终端运行 npx -y @spritesheetgen/cli login 并粘贴密钥,它只保存在你的用户目录里。
3. 说出游戏需要什么
比如:“给我的 Godot 项目做一个骑士,要行走和攻击动画。”助手会先看你已经有什么,报价,等你同意后才花积分。
4. 文件直接进项目
每个动画导出到一个新文件夹,比如 assets/sprites/knight_walk,不会覆盖你已有的文件。
工具一览
| 工具 | 积分 | 作用 |
|---|---|---|
estimate_sprite | 免费 | 查角色或动作的价格、余额和密钥剩余额度 |
create_character | 5 | 根据描述生成角色图 |
animate_character | 10 | 给角色做一个动画:行走、奔跑、待机、攻击或跳跃 |
get_generation | 免费 | 查看生成状态和结果 |
list_characters | 免费 | 列出你生成或上传的角色 |
list_actions | 免费 | 列出某个角色已有的动画 |
improve_prompt | 免费 | 把粗略的想法改写成更好生成的描述 |
upload_character | 免费 | 上传你自己的 PNG、JPEG 或 WebP 角色图,用来做动画 |
export_sprite_sheet | 免费 | 在本机把动画打包成精灵图 |
花多少积分由你控制
每个密钥自己的每日和总额度是硬上限,新密钥额度为 0。
每次付费调用都带着你同意的价格,价格更高就不扣费。
超时后重试会沿用同一个购买标识,同一个请求不会扣两次。
生成失败会退回账户积分,但不恢复密钥已消耗的额度;导出、列表和报价都免费。
手动安装
想自己配置的话(需要 Node.js 20 或更新版本):
Claude Code:
claude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli@latest mcpCodex:
codex mcp add spritesheetgen -- npx -y @spritesheetgen/cli@latest mcpCursor 和其他 MCP 客户端(
mcp.json):{ "mcpServers": { "spritesheetgen": { "command": "npx", "args": ["-y", "@spritesheetgen/cli@latest", "mcp"] } } }使用说明(skill):
npx -y @spritesheetgen/cli@latest skill install --dir ~/.claude/skills(或~/.codex/skills)密钥:
npx -y @spritesheetgen/cli login
不用 MCP 也能用同样的命令:npx -y @spritesheetgen/cli --help。npm 包名是 @spritesheetgen/cli。
放进游戏引擎
常见问题
支持哪些助手?
任何支持 stdio MCP 服务的助手:Claude Code、Codex、Cursor 等。Claude Code 和 Codex 还会装上使用说明(skill),它会先报价、等你同意再花积分。
助手能看到我的 API 密钥吗?
登录流程不会把密钥传入聊天、MCP 配置或工具返回结果。密钥保存在本机用户目录;有权读取该目录的助手仍可能读取它。不要把密钥发进聊天,并只给它需要的额度。
要花多少积分?
一张角色图 5 积分,每个动画 10 积分,和网站上一样。新账号赠送 25 积分。导出、列表和报价都免费。
能给我自己画的角色做动画吗?
可以。助手可以上传你自己画的或有授权的 PNG、JPEG、WebP 图片,然后像生成的角色一样做动画。
精灵图在哪里打包?
在你自己的电脑上,用的是和网站相同的代码。服务器只负责生成角色和动画;打包、去背景和像素化都在本地完成。
助手会不会超出我允许的额度?
不会。每个密钥都有自己的每日和总额度,由服务器检查。用完后助手会收到错误,只能来问你。