spine-mcp — Spine 2D 动画 MCP 服务器

从拆分好的角色直接制作可用于生产的 Spine 2D 动画——直接来自 .psd 或 PhotoshopToSpine 导出文件夹。灵感来自 ampersante/spine2d-animation-mcp，但它提供的是可在 spine-pixi / pixi 游戏中运行的真正运行时骨架，以及 可编辑的 .spine 工程（通过获得许可的 Spine 4.3 CLI），并带有手工制作的动作，而不是现成模板。

cut parts (you, in Photoshop)            ──▶  rig_and_animate
  PSD  or  PhotoshopToSpine export             │
                                               ├─▶ <name>.json   runtime skeleton (Spine 4.2)
                                               ├─▶ <name>.atlas + .png   packed atlas
                                               └─▶ <name>.spine  EDITABLE project (open in your Spine)
                                          ──▶  preview (montage PNG)  /  wire into the game

为什么它比原版更好

Related MCP server: spine-mcp

工具

• spine_doctor — 检查 Spine CLI 和 Python 依赖

• inspect_source — 在装配前列出部件 / 检测到的头部状态族

• rig_and_animate(source, out_dir, name?, kind?, anims?, make_editable?) — 主要工具

• pack_atlas(images_dir, out_dir, name) — Spine-CLI 图集打包

• make_project(runtime_json, out_spine) — 运行时 json → 可编辑的 .spine

• export_project(project, out_dir, fmt) — .spine → 运行时 json+atlas

• project_info(project_or_json) — 骨骼/插槽/动画

• preview(rig_dir, images_dir?, out_png?, maxpx?) — 关键帧拼贴 PNG

• batch(roster_dir, out_root, kind?, make_editable?) — 为每个导出子文件夹装配骨架

输入约定

• 头部状态族： 将备用面部命名为 <base>_win / <base>_blink （例如 head、head_win、head_blink，或 face、face_win、face_blink）。 它们会自动合并到一个插槽，并在 win / blink 中切换。

• 发光图层 命名为 Layer 2 → 加法混合 + 脉冲。名称包含 *fire* 的部件 → 闪烁。名称包含 *rot* 的部件 → 旋转点缀骨骼。

• 在每个部件的关节下方留一个小 重叠片，这样弯曲时不会撕裂。

安装

最简单的方式，是连同那个知道如何使用它的“大脑”一起安装：

/plugin marketplace add egorfedorov/mozg-plugin
/plugin install mozg-spine@mozg

或者直接接入——需要 uv：

claude mcp add spine -- uvx --from git+https://github.com/egorfedorov/spine-mcp spine-mcp

从代码检出开始，用于自行修改：

uv venv && uv pip install -e .
./.venv/bin/spine-mcp          # stdio MCP server

你的 Spine 许可证仍归你所有

本项目不包含 Spine 的任何部分，也不授予其任何许可证。Spine 是 Esoteric Software 的商业软件，每个人都在自己的许可证下运行自己的安装。服务器会在 /Applications/Spine.app/Contents/MacOS/Spine 或 SPINE_BIN 指向的位置查找它。

没有许可证也能工作。 装配和动画从不启动 Spine 进程——它们只是基于 Pillow 和 psd-tools 的纯 Python 代码。许可证会额外提供三个工具：

spine_doctor 会报告它找到的内容。一个人的许可证永远不会传到另一个人那里，也不会因为别人有不同许可证而导致任何功能降级。

它假设的命名约定

_classify 根据一个针对某工作室美术调优的单词列表来判断什么是头部——head, face, golova, crown, tooth。名为 kopf 或 cabeza 的图层会被归入身体。与其重命名你的美术资源，不如覆盖它：

export SPINE_HEAD_WORDS="kopf,gesicht,krone"

文件

• server.py — FastMCP 服务器（工具层）

• spine_rig.py — 装配 + 动画构建器（纯 Python，可导入，可独立运行）

• spine_cli.py — Spine 4.3 CLI 封装（打包 / 导入 / 导出 / 信息）

• spine_preview.py — 关键帧拼贴渲染器

许可证

MIT — 参见 LICENSE。为 mozg 的 Spine 2D Animation brain 编写并被其使用，后者是知道骨架应该如何移动的那一半。