Spine MCP Server
🦴 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: 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 ( |
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+ + |
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-extensionhinzufügen (odernpm run package:ccxausfü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
Render Spine 3.8 skeleton animations to PNG frames or GIF. Pay per call with points.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Create AI animations and export transparent sprite sheets, alpha video, frames, and game assets.
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables 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.61MIT
- FlicenseAqualityBmaintenanceEnables 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-
- AlicenseAqualityCmaintenanceEnables 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.261MIT
- AlicenseBqualityBmaintenanceThis 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.3816 npmMIT