spine-mcp — servidor MCP de animación Spine 2D

Crea animaciones Spine 2D de producción a partir de un personaje recortado, directamente desde un .psd o una carpeta de exportación de PhotoshopToSpine. Inspirado en ampersante/spine2d-animation-mcp, pero incluye rigs de runtime reales que funcionan en juegos spine-pixi / pixi y proyectos .spine editables (mediante la CLI con licencia de Spine 4.3), con movimiento artesanal en lugar de plantillas prefabricadas.

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

Por qué supera al original

Related MCP server: spine-mcp

Herramientas

• spine_doctor — comprueba Spine CLI + dependencias de Python

• inspect_source — lista las partes / familias de estados de cabeza detectadas antes del rigging

• rig_and_animate(source, out_dir, name?, kind?, anims?, make_editable?) — el principal

• pack_atlas(images_dir, out_dir, name) — empaquetado de atlas Spine-CLI

• make_project(runtime_json, out_spine) — json de runtime → .spine editable

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

• project_info(project_or_json) — huesos/slots/animaciones

• preview(rig_dir, images_dir?, out_png?, maxpx?) — PNG de montaje de fotogramas clave

• batch(roster_dir, out_root, kind?, make_editable?) — crea el rig de cada subcarpeta de exportación

Convenciones de entrada

• Familia de estados de cabeza: nombra las caras alternativas <base>_win / <base>_blink (p. ej. head, head_win, head_blink, o face, face_win, face_blink). Se colapsan automáticamente en un solo slot y se intercambian dentro de win / blink.

• Capa de brillo llamada Layer 2 → fusión aditiva + pulso. Las partes llamadas *fire* → parpadeo. Las partes llamadas *rot* → hueso de acento giratorio.

• Deja una pequeña pestaña de solapamiento en cada parte bajo su articulación para que los pliegues no se rompan.

Instalación

La forma sencilla, junto con el cerebro que sabe cómo usarlo:

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

O conéctalo directamente — necesita uv:

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

Desde un checkout, para trastear con él:

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

Tu licencia de Spine sigue siendo tuya

Este proyecto no contiene ninguna parte de Spine y no concede ninguna licencia sobre él. Spine es un software comercial de Esoteric Software, y cada cual ejecuta su propia instalación bajo su propia licencia. El servidor lo busca en /Applications/Spine.app/Contents/MacOS/Spine, o donde apunte SPINE_BIN.

Funciona sin una. El rigging y la animación nunca inician un proceso de Spine — son Python puro sobre Pillow y psd-tools. Una licencia añade tres herramientas:

spine_doctor informa de lo que ha encontrado. La licencia de una persona nunca llega a otra, y nada se degrada porque alguien tenga una distinta.

Convenciones de nombres que asume

_classify decide qué es una cabeza a partir de una lista de palabras ajustada al arte de un estudio — head, face, golova, crown, tooth. Una capa llamada kopf o cabeza acaba en el cuerpo en su lugar. Sobrescríbelo en lugar de renombrar tu arte:

export SPINE_HEAD_WORDS="kopf,gesicht,krone"

Archivos

• server.py — servidor FastMCP (superficie de herramientas)

• spine_rig.py — constructor de rig + animación (puro, importable, ejecutable de forma independiente)

• spine_cli.py — envoltorios de Spine 4.3 CLI (pack / import / export / info)

• spine_preview.py — renderizador de montaje de fotogramas clave

Licencia

MIT — consulta LICENSE. Escrito para, y utilizado por, mozg (su cerebro de Spine 2D Animation), que es la mitad que sabe cómo deben moverse los rigs.