Spine MCP Server
🦴 Spine MCP Server
AI駆動のSpine 3.8.75アニメーションワークフローサーバー — AIクライアント(Trae / Cursor / Claude Desktop)がSpineを直接操作できるようにします。
📖 概要
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のエクスポート → 変更 → その場でのインポート、自動バックアップ( |
バージョン互換性 | Spine 3.8.75に固定、他のバージョンには親切な警告 |
Cocos拡張 | Cocos Creator 3.8+ビジュアルパネル + |
インストーラーウィザード | ワンクリック環境検出 + 設定書き込み |
🔧 要件
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
Render Spine 3.8 skeleton animations to PNG frames or GIF. Pay per call with points.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Create AI animations and export transparent sprite sheets, alpha video, frames, and game assets.
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables 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.61MIT
- FlicenseAqualityBmaintenanceEnables 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-
- AlicenseAqualityCmaintenanceEnables 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.261MIT
- AlicenseBqualityBmaintenanceThis 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.3816 npmMIT