spine-mcp — Spine 2D 애니메이션 MCP 서버

잘라낸 캐릭터로 프로덕션용 Spine 2D 애니메이션을 만드세요 — .psd 또는 PhotoshopToSpine 내보내기 폴더에서 바로. ampersante/spine2d-animation-mcp에서 영감을 받았지만, spine-pixi / pixi 게임에서 실제로 재생되는 런타임 릭 그리고 편집 가능한 .spine 프로젝트(라이선스 Spine 4.3 CLI를 통해)를 제공하며, 템플릿이 아닌 수작업으로 제작된 모션을 사용합니다.

cut parts (you, in Photoshop)            ──▶  rig_and_animate
  PSD  or  PhotoshopToSpine export             │
                                               ├─▶ <name>.json   runtime skeleton (Spine 4.2)
                                               ├─▶ <name>.atlas + .png   packed atlas
                                               └─▶ <name>.spine  EDITABLE project (open in your Spine)
                                          ──▶  preview (montage PNG)  /  wire into the game

원본보다 나은 이유

Related MCP server: spine-mcp

도구

• spine_doctor — Spine CLI + Python 의존성 확인

• inspect_source — 릭 전에 파츠 / 감지된 머리 상태 패밀리 나열

• rig_and_animate(source, out_dir, name?, kind?, anims?, make_editable?) — 핵심 도구

• pack_atlas(images_dir, out_dir, name) — Spine-CLI 아틀라스 패킹

• make_project(runtime_json, out_spine) — 런타임 json → 편집 가능한 .spine

• export_project(project, out_dir, fmt) — .spine → 런타임 json+아틀라스

• project_info(project_or_json) — 본/슬롯/애니메이션

• preview(rig_dir, images_dir?, out_png?, maxpx?) — 키프레임 몽타주 PNG

• batch(roster_dir, out_root, kind?, make_editable?) — 모든 내보내기 하위 폴더 릭

입력 규칙

• 머리 상태 패밀리: 대체 얼굴 이름을 <base>_win / <base>_blink로 지정 (예: head, head_win, head_blink, 또는 face, face_win, face_blink). 자동으로 하나의 슬롯으로 통합되고 win / blink 안에서 스왑됩니다.

• 글로우 레이어 이름이 Layer 2 → 가산 블렌드 + 펄스. *fire*로 이름이 지정된 파츠 → 깜빡임. *rot*로 이름이 지정된 파츠 → 회전 액센트 본.

• 각 파츠의 관절 아래에 작은 오버랩 탭을 남겨 굽힘 시 찢어지지 않게 하세요.

설치

사용법을 아는 브레인과 함께하는 쉬운 방법:

/plugin marketplace add egorfedorov/mozg-plugin
/plugin install mozg-spine@mozg

또는 직접 연결 — uv 필요:

claude mcp add spine -- uvx --from git+https://github.com/egorfedorov/spine-mcp spine-mcp

체크아웃에서 직접 해킹하려면:

uv venv && uv pip install -e .
./.venv/bin/spine-mcp          # stdio MCP server

Spine 라이선스는 여러분의 것입니다

이 프로젝트는 Spine의 어떤 부분도 포함하지 않으며 Spine에 대한 라이선스를 부여하지 않습니다. Spine은 Esoteric Software의 상용 소프트웨어이며, 모든 사용자는 자신의 라이선스에 따라 자신의 설치본을 실행합니다. 서버는 /Applications/Spine.app/Contents/MacOS/Spine 또는 SPINE_BIN이 가리키는 위치에서 Spine을 찾습니다.

라이선스 없이도 작동합니다. 릭과 애니메이션은 Spine 프로세스를 시작하지 않습니다 — Pillow와 psd-tools를 사용하는 순수 Python입니다. 라이선스는 세 가지 도구를 추가합니다:

spine_doctor가 발견한 내용을 보고합니다. 한 사람의 라이선스는 다른 사람에게 도달하지 않으며, 다른 사람이 다른 라이선스를 가지고 있다고 해서 아무것도 저하되지 않습니다.

가정하는 명명 규칙

_classify는 한 스튜디오의 아트에서 튜닝된 단어 목록으로 머리를 판별합니다 — head, face, golova, crown, tooth. kopf 또는 cabeza라는 레이어는 몸통으로 분류됩니다. 아트 이름을 바꾸는 대신 오버라이드하세요:

export SPINE_HEAD_WORDS="kopf,gesicht,krone"

파일

• server.py — FastMCP 서버 (도구 표면)

• spine_rig.py — 릭 + 애니메이션 빌더 (순수, 임포트 가능, 단독 실행 가능)

• spine_cli.py — Spine 4.3 CLI 래퍼 (pack / import / export / info)

• spine_preview.py — 키프레임 몽타주 렌더러

라이선스

MIT — LICENSE 참조. mozg의 Spine 2D Animation brain을 위해 작성되었고 사용되고 있으며, 이는 릭이 어떻게 움직여야 하는지 아는 절반입니다.