spine-mcp — MCP-сервер для Spine 2D-анимации

Создавайте продакшен-анимации Spine 2D из разрезанного персонажа — прямо из .psd или папки экспорта PhotoshopToSpine. Вдохновлён ampersante/spine2d-animation-mcp, но поставляет настоящие рантайм-риги, которые проигрываются в играх на spine-pixi / pixi, а также редактируемые проекты .spine (через лицензированный CLI Spine 4.3) — с ручной анимацией вместо готовых шаблонов.

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 — перечисляет части и обнаруженные семейства head-state перед риггингом

• 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) — runtime json → редактируемый .spine

• export_project(project, out_dir, fmt) — .spine → runtime json+atlas

• project_info(project_or_json) — кости/слоты/анимации

• preview(rig_dir, images_dir?, out_png?, maxpx?) — PNG-коллаж ключевых кадров

• batch(roster_dir, out_root, kind?, make_editable?) — создаёт риги для каждой подпапки экспорта

Соглашения на входе

• Семейство head-state: называйте альтернативные лица <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 — коммерческое ПО от Esoteric Software, и каждый запускает свою собственную установку по своей лицензии. Сервер ищет его в /Applications/Spine.app/Contents/MacOS/Spine или там, куда указывает SPINE_BIN.

Он работает и без лицензии. Риггинг и анимация никогда не запускают процесс Spine — это обычный Python поверх Pillow и psd-tools. Лицензия добавляет три инструмента:

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 — обёртки над CLI Spine 4.3 (pack / import / export / info)

• spine_preview.py — рендер коллажа ключевых кадров

Лицензия

MIT — см. LICENSE. Написан для mozg и используется его Spine 2D Animation brain — той половиной, которая знает, как должны двигаться риги.