MCP 서버 + CLI
Claude Code, Codex, Cursor에 원하는 캐릭터와 동작을 말하면 SpriteSheetGen이 만들어 스프라이트 시트, JSON 아틀라스, Godot SpriteFrames 파일을 프로젝트에 넣어 줍니다.
모두 SpriteSheetGen으로 만든 걷기 애니메이션입니다(기사 이미지는 로고 그림이고, 애니메이션만 생성했습니다).
SpriteSheetGen을 설정해 줘: https://spritesheetgen.com/agents/install.txt 의 단계를 따라 줘
MCP 서버와 함께 도구 사용법, 예산, 엔진 가져오기를 아는 스킬이 설치됩니다.npx -y @spritesheetgen/cli loginclaude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli mcpcodex mcp add spritesheetgen -- npx -y @spritesheetgen/cli mcp{
"mcpServers": {
"spritesheetgen": {
"command": "npx",
"args": ["-y", "@spritesheetgen/cli", "mcp"]
}
}
}Node.js 20 이상이 필요합니다. 서버는 stdio로 동작하고 login으로 저장한 키(또는 SPRITESHEETGEN_API_KEY)를 읽으므로, 나중에 로그인해도 다시 시작할 필요가 없습니다.
| 도구 | 크레딧 | 하는 일 |
|---|---|---|
estimate_sprite | 무료 | 캐릭터나 동작의 가격, 잔액, 키의 남은 예산 확인 |
improve_prompt | 무료 | 대략적인 아이디어를 잘 생성되는 캐릭터 설명으로 다듬기(하루 무료 횟수 있음) |
create_character | 유료 | 설명으로 캐릭터 이미지 1장 생성 |
upload_character | 무료 | 직접 가진 PNG, JPEG, WebP 캐릭터 사용 |
animate_character | 유료 | 애니메이션 1개 생성: walk, run, idle, attack, jump |
get_generation | 무료 | 생성 상태와 결과 확인(완료까지 기다릴 수 있음) |
list_characters | 무료 | 생성하거나 업로드한 캐릭터 목록 |
list_actions | 무료 | 캐릭터가 이미 가진 애니메이션 목록(중복 결제 방지) |
export_sprite_sheet | 무료 | 완성된 애니메이션(또는 내 GIF)을 내 컴퓨터 폴더로 내보내기 |
에이전트는 먼저 가격을 알려 주고, 동의한 뒤에만 크레딧을 씁니다. 유료 호출에는 항상 max_credits 한도와 client_key가 붙어서 다시 시도해도 두 번 청구되지 않습니다. 새 계정은 25 크레딧을 받습니다. 현재 가격은 요금 페이지에서 확인하세요.
MCP 없이도 같은 기능을 쓸 수 있고, 스크립트용 --json 출력도 있습니다:
spritesheetgen estimate --description "a small beetle knight" --json
spritesheetgen character --description "a small beetle knight" --client-key my-key-0001 --max-credits 5 --json
spritesheetgen animate --reference generation:CHARACTER_ID --action walk --client-key my-key-0002 --max-credits 10 --json
spritesheetgen export --id ANIMATION_ID --out ./assets/beetle-walk --name walk --individual-frames --preview --json
가지고 있는 GIF를 내보낼 때는 키가 필요 없고 무료입니다:
npx -y @spritesheetgen/cli export --file ./walk.gif --out ./assets/walk --name hero_walk --preview
예시 결과물: 그린 스크린 위 기사의 걷기를 CLI로 내보낸 것(배경 제거, 가장자리 정리, 프레임 정렬).
| 파일 | 쓰는 곳 |
|---|---|
sheet.png | 모든 엔진: 프레임을 한 줄 또는 격자로 배치한 투명 PNG |
sheet.json | Phaser, PixiJS 등 TexturePacker JSON(hash)을 읽는 엔진(animations 포함) |
animation.tres | Godot 4: AnimatedSprite2D용 SpriteFrames 리소스(속도와 반복 설정 포함) |
preview.gif | 빠른 미리 보기 |
export.json | 사용한 설정(같은 내보내기를 반복할 때) |
frames/*.png | Unity, GameMaker 등 낱장 이미지가 필요한 도구(--individual-frames) |
this.load.atlas("knight", "sheet.png", "sheet.json");
this.anims.create({
key: "walk",
frames: this.anims.generateFrameNames("knight", { prefix: "knight_walk_", end: 11, zeroPad: 2 }),
frameRate: 14,
repeat: -1,
});
sheet.png와 animation.tres를 같은 폴더에 두고 AnimatedSprite2D를 추가한 뒤, animation.tres를 Sprite Frames 속성으로 끌어다 놓으세요.
위 기능은 모두 spritesheetgen.com에서도 쓸 수 있고, 내 기기에서 돌아가는 무료 도구도 있습니다: 동영상을 스프라이트 시트로, GIF를 스프라이트 시트로, 스프라이트 시트 만들기, 스프라이트 시트 자르기, 스프라이트 시트를 GIF로.