Skip to main content
Glama
Spine MCP Server

Spine MCP Server

by zhoushengmin

🦴 Spine MCP Server

中文 EN

KI-gesteuerter Animations-Workflow-Server für Spine 3.8.75 — ermöglicht es KI-Clients (Trae / Cursor / Claude Desktop), Spine direkt zu steuern.

Node Spine License


📖 Übersicht

Spine MCP Server ist ein Server, der auf dem MCP (Model Context Protocol) basiert und die Funktionen des Spine 3.8.75 Professional-Editors in 70 MCP-Tools kapselt, sodass KI-Clients direkt Folgendes tun können:

  • Spine-Projekte lesen (Knochen, Slots, Skins, Animationen, Events, Constraints)

  • Animations-Keyframes ändern (Rotation, Translation, Skalierung, Scherung, Kurven)

  • Skelettstruktur bearbeiten (Knochen, Slots, Attachments, Skins hinzufügen/löschen, Outfit-Wechsel)

  • Constraints (IK, Transform, Pfad) und Meshes (FFD-Deformation) manipulieren

  • Atlasse aufteilen (Teile aus Charakter-Illustrationen extrahieren), Auto-Rigging, Atlasse neu verpacken

  • Animations-Vorschauframes über die JS-Runtime rendern

  • Ein-Klick-Konfiguration, Start/Stopp des Dienstes und Generierung von KI-Client-Konfigurationen über das Cocos-Creator-Erweiterungsfenster

Related MCP server: GPT Spine MCP

✨ Funktionen

Funktion

Beschreibung

70 MCP-Tools

Deckt alle Spine-Bereiche ab (Info, Skelett, Attachments, Constraints, Animation, Atlas, Projekt)

Round-Trip-Modifikation

JSON exportieren → Ändern → Direkt importieren, automatische Sicherung (.bak)

Versionskompatibilität

Auf Spine 3.8.75 festgelegt, verständliche Warnungen für andere Versionen

Cocos-Erweiterung

Visuelles Panel für Cocos Creator 3.8+ + .ccx-Paketierung

Installationsassistent

Ein-Klick-Umgebungserkennung + Konfigurationserstellung

🔧 Anforderungen

  • Node.js ≥ 20 (getestet mit v22)

  • Spine.com (3.8.75 Professional, z. B. D:\cocos\SpinePro3.8.75\Spine.com)

  • Optional: Cocos Creator 3.8+ (für das Erweiterungsfenster)

🚀 Schnellstart

# 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"

🤖 MCP-Konfiguration

Fügen Sie die folgende Konfiguration zu den MCP-Server-Einstellungen Ihres Trae / Cursor / Claude Desktop hinzu:

{
  "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" }
    }
  }
}

⚠️ Wenn MCP „No tools yet“ anzeigt, starten Sie Ihren KI-Client neu, damit der Serverprozess neu geladen werden kann.

🧩 Tools (70)

Kategorie

Tools

Informationen (9)

get_project_info · inspect_json · describe · list_animations · list_events · list_constraints · get_attachments · get_animation_detail · render_preview

Skelettstruktur (10)

control_bone · add_bone · delete_bone · set_bone · mirror_bones · add_slot · delete_slot · set_slot · rename_slot · batch_rename

Attachments & Skins (7)

set_attachment · add_attachment · delete_attachment · set_attachment_transform · edit_mesh · set_skin · import_skin

Constraints (9)

add/set/delete × {ik, transform, path}

Animation (19)

add_simple_animation · generate_animation · list_effects · apply_effect · pose_to_animation · mirror_animation · mix_animations · mesh_wave · export_sheet · duplicate/delete/rename_animation · set_animation_settings · control_slot · control_constraint · add_event_keyframe · set_draw_order · set_curve · export_video

Workflow (2)

check_project · pipeline

Atlas & Projekt (9)

split_atlas · repack_atlas · import_image · export · import · clean · create_project · scale_project · rollback

Cocos-Toolchain (5)

list_cocos_assets · validate_references · build_skeleton · cut_parts · assemble

🎮 Cocos-Erweiterung

Das Verzeichnis cocos-extension/ stellt ein Panel für Cocos Creator 3.8+ bereit:

  • Installation: Erweiterungsmanager → Lokale Erweiterung → Verzeichnis cocos-extension hinzufügen (oder npm run package:ccx ausführen, um eine .ccx-Datei für den Import zu erzeugen)

  • Funktionen: MCP-Dienst starten/stoppen, Projekte scannen, KI-Konfiguration generieren, Dienststatus

  • Details finden Sie unter docs/cocos-extension-README.en.md

🧪 Tests

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

Testmatrix: Unit 20/20 · Phase 3 37/37 · Phase 4 45/45 · Phase 5 13/13 · MCP-Protokoll 10/10 (70 Tools) · Erweiterungs-Bridge 12/12

📚 Dokumentation

🗂 Projektstruktur

├── 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

💰 Support

Verfügbar im Swarms Marketplace

📄 Lizenz

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      F
      maintenance
      Enables AI agents to inspect, search, and edit Unreal Engine animation data including sequences, montages, blend spaces, animation blueprints, skeletons, and skeletal meshes via 62 tools over MCP.
      61
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Enables converting layered PSD or PhotoshopToSpine exports into validated Spine 2D rigs, animations, atlases, previews, runtime JSON, and optionally editable .spine projects. It provides MCP tools and an OpenAI/Codex workflow for rigging, animation generation, validation, preview auditing, and batch processing.
      14
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables an AI assistant to create, edit, validate and animate Esoteric Software Spine 2D skeletons without the editor running, covering bones, slots, attachments, skins, events, constraints, keyframes and reference-safe renames or deletions. When the Spine editor is installed, it also drives the official CLI to import skeleton JSON into a project and export runtime JSON/binary with atlases.
      26
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      This server enables AI agents to read, measure, view, and safely edit Spine 4.3 animations by bridging the gap between creative artistic decisions and technical requirements. It facilitates a comprehensive animation pipeline, ensuring all changes are verified, backed up, and ready for deployment across various rendering environments.
      38
      16 npm
      MIT