SpriteSheetGen 로고SpriteSheetGen

MCP 게임 개발: 에이전트로 게임 리소스 만들기

AI 코딩 에이전트에게 게임 캐릭터와 애니메이션을 요청하세요. 생성은 SpriteSheetGen이, 스프라이트 시트 작업은 내 컴퓨터에서 하고 프로젝트에 바로 들어갑니다.

1. 이 문장을 Claude Code, Codex 등 MCP를 지원하는 에이전트에 붙여 넣으세요

SpriteSheetGen을 설정해 줘: https://spritesheetgen.com/agents/install.txt 의 단계를 따라 줘

2. API 키를 만들고, 직접 연 터미널에서 이 명령을 실행해 키를 붙여 넣으세요

npx -y @spritesheetgen/cli login
API 키 만들기키는 채팅에 들어가지 않습니다. 새 키는 예산을 정하기 전까지 크레딧을 쓸 수 없습니다.

이 MCP로 할 수 있는 것

에이전트에게 9개의 도구를 줍니다. 설명으로 캐릭터 이미지를 만들고(직접 그린 이미지에 애니메이션을 넣을 수도 있습니다), 동작을 하나씩 더한 뒤 엔진이 바로 읽는 파일로 내보냅니다.

  • sheet.png: 투명 배경 격자에 놓인 모든 프레임

  • sheet.json: 프레임 위치와 애니메이션을 담은 TexturePacker JSON (Phaser 등 대부분의 엔진 지원)

  • animation.tres: AnimatedSprite2D에 바로 쓰는 Godot 4 SpriteFrames

  • export.json: 프레임 크기, 프레임 수, fps. 원하면 개별 프레임과 미리보기 GIF도

빨간 망토와 둥근 방패를 든 SD 기사의 8프레임 걷기 애니메이션. 에이전트가 MCP로 만들고 투명 배경 스프라이트 시트로 내보낸 것
이 MCP 서버로 에이전트가 만든 결과: “a small knight with a red cape and a round shield”에 걷기 애니메이션을 더해 8프레임 투명 스프라이트 시트로 내보냈습니다(절반 크기로 표시).

사용 방법

1. 한 문장으로 설치

위 문장을 에이전트에 붙여 넣으세요. 에이전트가 install.txt를 읽고, 작업 방법을 알려 주는 스킬을 설치하고, 키 없이 MCP 서버를 추가합니다.

2. 예산이 있는 키 주기

계정 페이지에서 키를 만들고 “캐릭터와 동작 생성”을 선택한 뒤 하루와 전체 사용 크레딧을 정하세요. 그다음 직접 연 터미널에서 npx -y @spritesheetgen/cli login을 실행하고 키를 붙여 넣으면, 키는 내 사용자만 읽을 수 있는 곳에 저장됩니다.

3. 게임에 필요한 것 요청하기

예: “내 Godot 프로젝트에 걷기와 공격 애니메이션이 있는 기사를 만들어 줘.” 에이전트는 이미 있는 것을 확인하고 가격을 알려 준 뒤, 동의를 받고 나서 크레딧을 씁니다.

4. 파일이 프로젝트에 들어감

애니메이션마다 새 폴더(예: assets/sprites/knight_walk)로 내보내며, 기존 파일은 덮어쓰지 않습니다.

도구 목록

도구크레딧기능
estimate_sprite무료캐릭터나 동작의 가격, 잔액, 키의 남은 예산
create_character5설명으로 캐릭터 이미지 생성
animate_character10캐릭터 애니메이션 하나 생성: 걷기, 달리기, 대기, 공격, 점프
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 mcp

  • Codex: codex mcp add spritesheetgen -- npx -y @spritesheetgen/cli@latest mcp

  • Cursor 등 MCP 클라이언트 (mcp.json): { "mcpServers": { "spritesheetgen": { "command": "npx", "args": ["-y", "@spritesheetgen/cli@latest", "mcp"] } } }

  • 스킬: 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입니다.

엔진에 넣기

  • Godot 4: AnimatedSprite2D의 Sprite Frames를 animation.tres로 정하고 재생합니다.

  • Phaser 3: this.load.atlas로 sheet.png와 sheet.json을 불러옵니다.

  • Unity: export.json의 프레임 크기로 sheet.png를 Grid By Cell Size로 자릅니다.

  • GameMaker: Import Strip에서 export.json의 프레임 수, 행당 프레임 수(columns), 프레임 크기를 설정합니다.

GIF나 동영상 애니메이션이 이미 있다면 무료 GIF 스프라이트 시트와 동영상 프레임 추출 도구로 브라우저에서 정리할 수 있습니다.

자주 묻는 질문

어떤 에이전트에서 쓸 수 있나요?

stdio MCP 서버를 지원하는 에이전트라면 됩니다: Claude Code, Codex, Cursor 등. Claude Code와 Codex에는 스킬도 설치되어, 먼저 견적을 내고 쓰기 전에 묻습니다.

에이전트가 내 API 키를 보나요?

로그인 과정에서 키를 채팅, MCP 설정, 도구 응답으로 보내지 않습니다. 다만 로컬 사용자 폴더에 저장되므로 해당 파일을 읽을 권한이 있는 에이전트는 접근할 수 있습니다. 채팅에 붙여 넣지 말고 필요한 예산만 설정하세요.

비용은 얼마인가요?

캐릭터 이미지는 5크레딧, 애니메이션은 하나에 10크레딧으로 웹사이트와 같습니다. 새 계정에는 25크레딧이 주어집니다. 내보내기, 목록, 견적은 무료입니다.

직접 그린 캐릭터도 움직일 수 있나요?

네. 직접 만들었거나 사용 허락을 받은 PNG, JPEG, WebP를 올리면 생성한 캐릭터처럼 애니메이션을 만들 수 있습니다.

스프라이트 시트는 어디서 만들어지나요?

내 컴퓨터에서, 웹사이트와 같은 코드로 만들어집니다. 서버는 캐릭터와 애니메이션 생성만 하고, 내보내기·배경 제거·픽셀화는 로컬에서 실행됩니다.

허락한 것보다 더 쓸 수 있나요?

아니요. 키마다 하루와 전체 크레딧 예산이 있고 서버가 확인합니다. 다 쓰면 에이전트는 오류를 받고 나에게 물어봐야 합니다.

다른 무료 스프라이트 도구