Skip to main content
Glama
Spine MCP Server

Spine MCP Server

by zhoushengmin

🦴 Spine MCP Server

中文 EN

AI駆動のSpine 3.8.75アニメーションワークフローサーバー — AIクライアント(Trae / Cursor / Claude Desktop)がSpineを直接操作できるようにします。

Node Spine License


📖 概要

Spine MCP Serverは、MCP (Model Context Protocol)上に構築されたサーバーで、Spine 3.8.75 Professionalエディタの機能を70個のMCPツールとしてラップし、AIクライアントが以下を直接実行できるようにします:

  • Spineプロジェクトの読み取り(ボーン、スロット、スキン、アニメーション、イベント、コンストレイント)

  • アニメーションキーフレームの変更(回転、移動、スケール、シアー、カーブ)

  • スケルトン構造の編集(ボーン、スロット、アタッチメント、スキンの追加/削除、衣装の差し替え)

  • コンストレイント(IK、トランスフォーム、パス)とメッシュ(FFD変形)の操作

  • アトラスの分割(キャラクターイラストからのパーツ抽出)、自動リギング、アトラスの再パック

  • JSランタイムによるアニメーションプレビューフレームのレンダリング

  • Cocos Creator拡張パネルによるワンクリック設定、サービスの開始/停止、AIクライアント設定の生成

Related MCP server: GPT Spine MCP

✨ 機能

機能

説明

70個のMCPツール

Spineの全領域(情報、スケルトン、アタッチメント、コンストレイント、アニメーション、アトラス、プロジェクト)をカバー

ラウンドトリップ変更

JSONのエクスポート → 変更 → その場でのインポート、自動バックアップ(.bak)

バージョン互換性

Spine 3.8.75に固定、他のバージョンには親切な警告

Cocos拡張

Cocos Creator 3.8+ビジュアルパネル + .ccxパッケージング

インストーラーウィザード

ワンクリック環境検出 + 設定書き込み

🔧 要件

  • Node.js ≥ 20(v22でテスト済み)

  • Spine.com(3.8.75 Professional、例:D:\cocos\SpinePro3.8.75\Spine.com)

  • オプション:Cocos Creator 3.8+(拡張パネル用)

🚀 クイックスタート

# 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設定

以下の設定をTrae / Cursor / Claude DesktopのMCPサーバー設定に追加してください:

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

⚠️ MCPに「No tools yet」と表示される場合は、AIクライアントを再起動してサーバープロセスをリロードしてください。

🧩 ツール(70)

カテゴリ

ツール

情報(9)

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

スケルトン構造(10)

control_bone · add_bone · delete_bone · set_bone · mirror_bones · add_slot · delete_slot · set_slot · rename_slot · batch_rename

アタッチメント&スキン(7)

set_attachment · add_attachment · delete_attachment · set_attachment_transform · edit_mesh · set_skin · import_skin

コンストレイント(9)

add/set/delete × {ik, transform, path}

アニメーション(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

ワークフロー(2)

check_project · pipeline

アトラス&プロジェクト(9)

split_atlas · repack_atlas · import_image · export · import · clean · create_project · scale_project · rollback

Cocosツールチェーン(5)

list_cocos_assets · validate_references · build_skeleton · cut_parts · assemble

🎮 Cocos拡張機能

cocos-extension/ディレクトリには、Cocos Creator 3.8+用のパネルが含まれています:

  • インストール:拡張機能マネージャー → ローカル拡張機能 → cocos-extensionディレクトリを追加(またはnpm run package:ccxを実行して.ccxファイルを生成しインポート)

  • 機能:MCPサービスの開始/停止、プロジェクトのスキャン、AI設定の生成、サービスステータス

  • 詳細はdocs/cocos-extension-README.en.mdを参照してください

🧪 テスト

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

テストマトリクス:ユニット 20/20 · フェーズ3 37/37 · フェーズ4 45/45 · フェーズ5 13/13 · MCPプロトコル 10/10(70ツール) · 拡張ブリッジ 12/12

📚 ドキュメント

🗂 プロジェクト構造

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

💰 サポート

Swarms Marketplaceで利用可能です

📄 ライセンス

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