Back to search
spine2d-animation-mcp
MCP serverGitHub
MCP server for creating SPINE2D animations
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/ampersante--spine2d-animation-mcp)HTML
<a href="/listings/ampersante--spine2d-animation-mcp"><img src="/api/listings/ampersante--spine2d-animation-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
uv sync
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 89 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # spine2d-mcp
- An MCP server that converts a layered PSD character into a [Spine](http://esotericsoftware.com/) 4.2 project — skeleton JSON, texture atlas, and atlas page PNG(s) — ready to import into the Spine editor and Unity.
- The goal is to cut the manual rig-and-import work for a character from days down to roughly an hour.
- ## Status
- **Phase 0 (proof of concept):** PSD → a correct, importable rig (no animations yet).
- The pipeline is implemented and covered by tests against synthetic fixtures. It has not yet been validated against a real PSD in the Spine editor / Unity — that is the next milestone. Animation generation, headless preview, and Unity export are planned for later phases.
- ## What it does today
- Given a PSD whose layers are named after body parts (`head`, `body`/`torso`, `arm_left`, `hand_right`, `leg_left`, `foot_right`, …), the `import_psd_to_spine` tool produces:
- - `<name>.json` — Spine 4.2 skeleton (bones, slots, default skin, region attachments)
- - `<name>.atlas` — libgdx/Spine texture atlas
- - `<name>.png` — packed atlas page(s)
- Key behaviors:
- - **Multi-segment skeleton** (`root → hip → torso → chest → neck → head`, limbs off `chest`, legs off `hip`); missing intermediate bones are created as positioned virtual bones.
- - **Joint-correct pivots** — each bone pivots at the joint edge of its part (or an explicit `<part>[pivot]` marker layer), not the image center, so rotation behaves anatomically.
- - **PSD draw order** is preserved as Spine slot order.
- - **Structural validation** of the skeleton against the invariants the Spine 4.2 reader enforces.
- Format source of truth: `reference/SkeletonJson.java` (spine-runtimes 4.2).
- ## Requirements
- - Python 3.11+
- - [uv](https://docs.astral.sh/uv/)
- ## Setup
- ```bash
- uv sync
- ```
- ## Run the tests
- ```bash
- uv run pytest
- ```
- ## Run the MCP server
- ```bash
- uv run spine2d-mcp
- ```
- This starts a stdio MCP server exposing a single tool:
- ```
- import_psd_to_spine(psd_path: str, out_dir: str | None = None)
- -> { project_path, atlas_path, png_paths }
- ```
- Point an MCP client (e.g. Claude Desktop / Claude Code) at it, then ask it to import a PSD by path.
- ## Project layout
- ```
- src/spine2d_mcp/
- server.py FastMCP server + import_psd_to_spine tool
- pipeline.py PSD -> Spine project orchestration
- psd/parser.py PSD -> flat layer list (+ pivot markers)
- psd/conventions.py bone hierarchy, joint sides, [pivot] tag
- spine/schema.py Pydantic models for Spine 4.2 JSON
- spine/builder.py layers -> SpineProject
- spine/writer.py SpineProject -> JSON
- spine/validator.py structural validation
- atlas/packer.py rectpack bin packing
- atlas/writer.py .atlas text + composite PNG
- reference/ SkeletonJson.java, spineboy.atlas (format references)
- tests/ pytest suite (synthetic PSD fixtures)
- ```
- ## License
- This project is released under the MIT License.
- You may use, copy, modify, merge, publish, distribute, sublicense, and sell copies
- of the software, provided that the original copyright notice and license text are
- included with substantial portions of the software.
- The software is provided "as is", without warranty of any kind. See
- [LICENSE](LICENSE) for the full license text.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.