🦴 Spine MCP Server

Servidor de flujo de trabajo de animación Spine 3.8.75 impulsado por IA — permite que los clientes de IA (Trae / Cursor / Claude Desktop) controlen Spine directamente.

📖 Descripción general

Spine MCP Server es un servidor construido sobre MCP (Model Context Protocol) que envuelve las capacidades del editor Spine 3.8.75 Professional en 70 herramientas MCP, permitiendo a los clientes de IA directamente:

• Leer proyectos de Spine (huesos, slots, skins, animaciones, eventos, restricciones)

• Modificar fotogramas clave de animación (rotación, traslación, escala, cizallamiento, curvas)

• Editar la estructura del esqueleto (añadir/eliminar huesos, slots, attachments, skins, intercambio de atuendos)

• Manipular restricciones (IK, transform, path) y mallas (deformación FFD)

• Dividir atlas (extraer partes de ilustraciones de personajes), auto-rig, reempaquetar atlas

• Renderizar fotogramas de vista previa de animación mediante el runtime de JS

• Configuración con un clic, iniciar/detener el servicio y generar configuraciones de clientes de IA mediante el panel de extensión de Cocos Creator

Related MCP server: unreal-animation-mcp

✨ Características

🔧 Requisitos

• Node.js ≥ 20 (probado en v22)

• Spine.com (3.8.75 Professional, p. ej. D:\cocos\SpinePro3.8.75\Spine.com)

• Opcional: Cocos Creator 3.8+ (para el panel de extensión)

🚀 Inicio rápido

# 1. Install dependencies + build
npm install
npm run build

# 2. Configure Spine path (or run the installer wizard)
npm run installer        # Auto-detect Spine/Cocos/Node and write .env

# 3. Verify
node dist/index.js check
node dist/index.js info "D:/cocos/SpinePro3.8.75/examples/hero/hero-pro.spine"

🤖 Configuración de MCP

Añade la siguiente configuración a los ajustes del servidor MCP de tu Trae / Cursor / Claude Desktop:

{
  "mcpServers": {
    "spine-mcp": {
      "command": "node",
      "args": ["D:/cocos/spine-mcp-server/dist/index.js", "mcp"],
      "env": { "SPINE_EXE": "D:/cocos/SpinePro3.8.75/Spine.com" }
    }
  }
}

⚠️ Si MCP muestra "No hay herramientas todavía", reinicia tu cliente de IA para permitir que el proceso del servidor se recargue.

🧩 Herramientas (70)

🎮 Extensión de Cocos

El directorio cocos-extension/ proporciona un panel de Cocos Creator 3.8+:

• Instalación: Administrador de extensiones → Extensión local → Añadir el directorio cocos-extension (o ejecuta npm run package:ccx para generar un archivo .ccx para importar)

• Características: Iniciar/detener el servicio MCP, escanear proyectos, generar configuración de IA, estado del servicio

• Consulta docs/cocos-extension-README.en.md para más detalles

🧪 Pruebas

npm run test:all     # Run all test suites (unit + integration + MCP protocol + extension bridge)
npm run test:unit    # Unit tests only (node:test)

Matriz de pruebas: Unitarias 20/20 · Fase 3 37/37 · Fase 4 45/45 · Fase 5 13/13 · Protocolo MCP 10/10 (70 herramientas) · Puente de extensión 12/12

📚 Documentación

• Manual de usuario (EN)

• Manual de usuario (中文)

• README de la extensión de Cocos (EN)

• README de la extensión de Cocos (中文)

🗂 Estructura del proyecto

├── src/                  # Source code (TypeScript)
│   ├── server.ts         # MCP stdio server
│   ├── spine/            # Core: cli-executor / json-handler / export / import / render / split ...
│   ├── tools/            # 70 tools (registered in registry.ts)
│   └── utils/            # Config / logger / error codes / file utilities
├── cocos-extension/      # Cocos Creator extension (panel)
├── scripts/              # Installer wizard / .ccx packaging
├── tests/                # All test suites
└── docs/                 # Specs, manuals, progress

💰 Soporte

Disponible en el Swarms Marketplace

📄 Licencia

MIT