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+アトラス

• 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）。これらは自動的に1つのスロットにまとめられ、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 に対するライセンスを付与するものではありません。Spine は Esoteric Software の商用ソフトウェアであり、各ユーザーは自分のライセンスの下で自分のインストールを実行します。サーバーは /Applications/Spine.app/Contents/MacOS/Spine または SPINE_BIN が指す場所で Spine を探します。

ライセンスなしでも動作します。 リギングとアニメーションは Spine プロセスを起動しません — これらは Pillow と psd-tools を使った純粋な Python です。ライセンスにより3つのツールが追加されます:

spine_doctor は見つけたものを報告します。ある人のライセンスが別の人に届くことはなく、他の人が異なるライセンスを持っているからといって何かが劣化することもありません。

想定される命名規則

_classify は、あるスタジオのアートに合わせて調整された単語リストからヘッドを決定します — head, face, golova, crown, tooth。kopf や cabeza という名前のレイヤーは代わりにボディに配置されます。アートをリネームするのではなく、これをオーバーライドしてください:

export SPINE_HEAD_WORDS="kopf,gesicht,krone"

ファイル

• server.py — FastMCP サーバー（ツールサーフェス）

• spine_rig.py — リグ + アニメーションビルダー（純粋、インポート可能、スタンドアロンで実行可能）

• spine_cli.py — Spine 4.3 CLI ラッパー（パック / インポート / エクスポート / 情報）

• spine_preview.py — キーフレームモンタージュレンダラー

ライセンス

MIT — LICENSE を参照。 mozg の Spine 2D Animation brain のために書かれ、使用されています。これはリグがどのように動くべきかを知っている半分です。