Skip to main content
Glama
Spine MCP Server

Spine MCP Server

by zhoushengmin

🦴 Spine MCP Server

中文 EN

AI-driven Spine 3.8.75 animation workflow server — lets AI clients (Trae / Cursor / Claude Desktop) directly control Spine.

Node Spine License


📖 Overview

Spine MCP Server is a server built on the MCP (Model Context Protocol) that wraps Spine 3.8.75 Professional editor capabilities into 70 MCP tools, allowing AI clients to directly:

  • Read Spine projects (bones, slots, skins, animations, events, constraints)

  • Modify animation keyframes (rotation, translation, scale, shear, curves)

  • Edit skeleton structure (add/delete bones, slots, attachments, skins, outfit swapping)

  • Manipulate constraints (IK, transform, path) and meshes (FFD deformation)

  • Split atlases (extract parts from character illustrations), auto-rig, repack atlases

  • Render animation preview frames via JS runtime

  • One-click configuration, start/stop service, and generate AI client configs via Cocos Creator extension panel

Related MCP server: GPT Spine MCP

✨ Features

Capability

Description

70 MCP Tools

Covers all Spine domains (info, skeleton, attachments, constraints, animation, atlas, project)

Round-Trip Modification

Export JSON → Modify → In-place import, automatic backup (.bak)

Version Compatibility

Locked to Spine 3.8.75, friendly warnings for other versions

Cocos Extension

Cocos Creator 3.8+ visual panel + .ccx packaging

Installer Wizard

One-click environment detection + config writing

🔧 Requirements

  • Node.js ≥ 20 (tested on v22)

  • Spine.com (3.8.75 Professional, e.g. D:\cocos\SpinePro3.8.75\Spine.com)

  • Optional: Cocos Creator 3.8+ (for extension panel)

🚀 Quick Start

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

Add the following configuration to your Trae / Cursor / Claude Desktop MCP server settings:

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

⚠️ If MCP shows "No tools yet", restart your AI client to allow the server process to reload.

🧩 Tools (70)

Category

Tools

Information (9)

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

Skeleton Structure (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 & Project (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 Extension

The cocos-extension/ directory provides a Cocos Creator 3.8+ panel:

  • Installation: Extension Manager → Local Extension → Add cocos-extension directory (or run npm run package:ccx to generate a .ccx file for import)

  • Features: Start/stop MCP service, scan projects, generate AI config, service status

  • See docs/cocos-extension-README.en.md for details

🧪 Tests

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

Test matrix: Unit 20/20 · Phase 3 37/37 · Phase 4 45/45 · Phase 5 13/13 · MCP Protocol 10/10 (70 tools) · Extension Bridge 12/12

📚 Docs

🗂 Project Structure

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

Available on the Swarms Marketplace

📄 License

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