Integrates with Esoteric Software's Spine ecosystem, utilizing the Spine JSON format, Spine CLI for project export/import, and the official spine-player for rendering, enabling programmatic animation workflows that complement the Spine editor.
Allows authoring, preview, and export of skeletal animations using the Spine 2D animation tool, including keyframe authoring with easing presets, animation templates, GIF preview, round-trip with Spine CLI, and mobile performance linting.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Spine Motion MCP inspect the skeleton in assets/demo.json"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Spine 2D animation — author, preview and export skeletal animations via natural language, from Claude Code or any MCP client.
Runs as a local HTTP server with a built-in web dashboard: each user starts the server on their own machine and connects with their own Claude account — same model as Unity MCP.
Author animations programmatically on the documented Spine JSON format:
keyframes with easing presets (easeInOut, overshoot, anticipation, …) — bezier
handles are computed for you.
Animation templates that encode animation principles: idle_breath, ui_bounce,
hit_react, walk_cycle, attack_swing, celebrate, death, blink — parametric,
then refine with keys_set.
Render to GIF (preview_gif): headless Chrome + the official spine-player render
any animation to an animated GIF — the agent looks at it and iterates; humans share
it in chat.
Round-trip with the Spine editor via the official Spine CLI:
authored JSON → .spine project artists can open; .spine → runtime JSON + packed atlas.
See the result: the dashboard embeds the official Spine web player. An agent can screenshot the preview page (e.g. with Playwright MCP) and iterate on what it sees.
Mobile performance lint: bone budgets, key density, deform/clipping cost, draw-order churn, loop pops.
Related MCP server: spine-mcp
Node.js ≥ 18
For import/export tools only: a licensed Spine editor install (the CLI ships with the editor). Authoring, lint and preview work without it.
For preview_gif only: a Chrome-family browser (Chrome/Edge/Chromium; auto-detected,
or set SPINE_MCP_CHROME). No bundled browser download.
Spine 4.2.x (JSON format is version-coupled; pin via SPINE_MCP_EDITOR_VERSION.
The embedded spine-player is pinned to 4.2.x for the same reason).
git clone https://github.com/nihatcagri44/spine-motion-mcp.git
cd spine-motion-mcp
npm install
npm run build
SPINE_MCP_ROOT=/path/to/your/spine/assets npm startThen connect Claude Code:
claude mcp add --transport http spine http://localhost:8734/mcpOpen the dashboard at http://localhost:8734/ — server status, skeleton browser, live animation preview.
Variable | Default | Purpose |
|
| HTTP port (MCP endpoint + dashboard) |
| cwd | Root directory for skeleton files (sandbox) |
| auto-detect | Path to the Spine executable |
|
| Version passed to Spine CLI |
Auto-detected CLI paths: macOS /Applications/Spine.app/Contents/MacOS/Spine,
Windows C:\Program Files\Spine\Spine.com.
Tool | Needs Spine CLI | Purpose |
| – | Health check, easings & templates list |
| – | Bone tree, slots, skins, animations |
| – | Batch keyframes with easing presets |
| – | Generate an animation from a template |
| – | Fix loop continuity pops |
| – | Mobile perf & hygiene checks |
| ✅ | Authored JSON → |
| ✅ |
|
| – | Dashboard URL rendering the animation |
| – | Render an animation to an animated GIF (needs Chrome) |
skeleton_inspect — learn the rig
template_apply (e.g. idle_breath) — solid base
preview_gif → look at the GIF → evaluate motion visually
keys_set — refine timing/easing; loop_smooth if it loops
skeleton_lint — check mobile budgets
to_spine_project — hand off to an artist, or export_runtime → game
v0.1 — early. Authoring/lint/preview are functional; CLI round-trip flags follow
the official docs but are still being validated on Windows (see TESTING.md).
Mesh/deform authoring and PSD→rig bootstrap are on the roadmap.
MIT. Spine is a product of Esoteric Software; using the Spine editor/CLI and runtimes requires a valid Spine license.
This server cannot be deployed
Make animated videos by asking Claude, Cursor or any MCP client. Your AI writes it, we render it.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Generate authentic pixel art - sprites, animations, and tilesets - from any MCP client
