🦴 Spine MCP Server

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

📖 Ü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: unreal-animation-mcp

✨ Funktionen

🔧 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)

🎮 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

• Benutzerhandbuch (EN)

• Benutzerhandbuch (中文)

• Cocos-Erweiterung README (EN)

• Cocos-Erweiterung README (中文)

🗂 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