Minigame Assets MCP Server
AI를 활용해 게임 에셋을 자동 생성하는 MCP(Model Context Protocol) 서버입니다.
Claude와 대화하면서 캐릭터·스프라이트·배경·무기·로고·썸네일·음악·영상을 바로 만들 수 있습니다.
주요 기능
| 카테고리 | 도구 | AI |
|---|
| 게임 컨셉 | asset_create_concept_md — CONCEPT.md 생성 | - |
| 실행 계획 | asset_generate_execution_plan — 엔진 감지 + 단계별 계획 | - |
| 캐릭터 베이스 | asset_generate_character_base — 정면 서 있는 캐릭터 (role: player/enemy/monster/npc) | OpenAI gpt-image-2 (마젠타 크로마키 → 투명) |
| 장비 결합 베이스 | asset_generate_character_equipped — 베이스 + 무기/방어구 다중 레퍼런스 합성 | OpenAI gpt-image-2 edit (스프라이트 재사용 가능) |
| 스프라이트 | asset_generate_sprite_sheet — idle/walk/run/attack/death 등, 기본 1행 가로 스트립 | OpenAI gpt-image-2 edit (마젠타 크로마키) |
| 무기 아이콘 | asset_generate_weapons — 아이콘 일괄 생성 | OpenAI gpt-image-1 (투명 배경, 네이티브) |
| 배경 | asset_generate_screen_background — 게임 씬 배경 | gpt-image-2 (static) / Gemini (parallax 투명 레이어) |
| 로딩 화면 | asset_generate_loading_screen — 하단 20% 프로그레스바 영역 확보 | OpenAI gpt-image-2 (히어로·배경 레퍼런스 지원) |
| 로비 화면 | asset_generate_lobby_screen — menu_side로 UI 영역 지정 | OpenAI gpt-image-2 (히어로 쇼케이스) |
| 앱 로고 | asset_generate_app_logo — 600×600px | OpenAI / Gemini |
| 썸네일 | asset_generate_thumbnail — 1932×828px | OpenAI gpt-image-2 edit (캐릭터·배경 레퍼런스 합성) |
| 편집 | asset_edit_character_design, asset_remove_background 등 | OpenAI / Gemini |
| 음악 | asset_generate_music_local | 로컬 AudioCraft/MusicGen |
| 영상 | asset_generate_video_gemini, asset_generate_video_openai | Gemini Veo / OpenAI Sora |
| 프롬프트 확장 | 대부분 이미지 도구에 refine_prompt: true opt-in | OpenAI GPT-5.4-nano (한국어/짧은 입력 상세화) |
| 품질 검토 | asset_review — 구조·크로마 잔류·비주얼 AI 체크 | Gemini Vision (비주얼) + 비 AI (구조) |
| 검증 | asset_validate, asset_list_missing, asset_generate_atlas_json | - |
전체 도구 목록은 아래 도구 레퍼런스 참고
요구사항
설치
두 가지 방식 중 하나를 선택하세요. 특성이 다르고, 병용하면 같은 이름 minigame-assets 로 충돌합니다 (settings.json 엔트리가 플러그인의 .mcp.json 을 이기므로 플러그인 측 MCP 정의는 무시됨; 슬래시 커맨드·스킬은 정상 작동).
| 방식 | 장점 | 단점 | 추천 |
|---|
| 방법 1 — MCP 서버 수동 등록 | 키가 settings.json 에 박혀 Claude Code 를 GUI·터미널 어느 쪽으로 띄워도 작동 / 셸 rc 수정 불필요 | 슬래시 커맨드·스킬·자동 업데이트 없음 / CONCEPT-first 워크플로는 Claude 가 알아서 지켜줘야 함 | 단순히 asset_* 도구만 필요할 때 |
| 방법 2 — Claude Code 플러그인 | MCP + 슬래시 커맨드 3종 + CONCEPT-first 스킬 + 자동 업데이트 한 번에 | API 키를 셸 env 로 옮겨야 함 / macOS GUI 실행 시 launchctl setenv 별도 필요 | 워크플로까지 자동화하고 싶을 때 (대부분의 사용자) |
방법 1 — MCP 서버 수동 등록
터미널에서 한 줄로:
claude mcp add minigame-assets --scope user \
-e OPENAI_API_KEY=sk-... \
-e GEMINI_API_KEY=AIza... \
-- npx -y minigame-assets-mcp@latest
--scope user: 모든 프로젝트에서 사용 가능 (~/.claude/settings.json)-e KEY=VALUE: API 키를 MCP 서버 프로세스 env 로 주입 — Claude Code 실행 경로(GUI/터미널) 무관
선택 환경변수까지 포함:
claude mcp add minigame-assets --scope user \
-e OPENAI_API_KEY=sk-... \
-e GEMINI_API_KEY=AIza... \
-e ASSETS_OUTPUT_DIR=./generated-assets \
-e LOCAL_MUSIC_SERVER_URL=http://localhost:7860 \
-- npx -y minigame-assets-mcp@latest
확인:
claude mcp list
# minigame-assets: npx -y minigame-assets-mcp@latest - ✓ Connected
재설치 / 키 갱신:
claude mcp remove minigame-assets
# 위 add 명령 다시 실행 (새 키로)
방법 2 — Claude Code 플러그인
① 플러그인 설치
/plugin marketplace add LimSuyun/minigame-assets-mcp
/plugin install minigame-assets@minigame-assets-mcp
설치되는 것:
- MCP 서버
minigame-assets — npx -y minigame-assets-mcp@latest 자동 실행
- 슬래시 커맨드:
/create-minigame-assets, /setup-minigame-assets-concept, /minigame-assets-help
- 자동 발동 스킬
minigame-assets-workflow — 에셋 생성 요청 감지 시 CONCEPT.md 를 먼저 생성하도록 워크플로 강제
- SessionStart 훅 — 6시간마다 백그라운드로 플러그인 최신 커밋 동기화
② API 키를 셸 환경변수로
zsh (macOS 기본):
# ~/.zshrc 에 추가
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="AIza..."
적용: source ~/.zshrc
bash: 위 내용을 ~/.bashrc 또는 ~/.bash_profile 에.
보안 강화 팁 — dotfiles 를 git 으로 관리한다면 ~/.config/secrets.env 에 키를 chmod 600 으로 분리하고 ~/.zshrc 에서 [ -f ~/.config/secrets.env ] && source ~/.config/secrets.env 로 로드.
③ 확인
Claude Code 재시작 후:
claude mcp list # minigame-assets: ✓ Connected
⚠️ macOS GUI 실행 시 주의 — Finder/Dock 아이콘으로 Claude Code 를 띄우면 ~/.zshrc 의 export 가 상속되지 않습니다. 해결:
launchctl setenv OPENAI_API_KEY "sk-..."
launchctl setenv GEMINI_API_KEY "AIza..."
(재부팅마다 재설정. 영구 유지하려면 ~/Library/LaunchAgents/ 에 plist 배치.) 터미널에서 claude 명령으로 실행하는 패턴이면 이 이슈 없음.
업데이트 — 자동 (상세: plugins/minigame-assets/README.md).
방법 전환 (이주)
affaan-m
xhyqaq
OthmanAdi
nyldn
obra
anthropics