Skip to main content
Glama
deenesjakoruzh
zhoushengmin

Spine MCP Server

by zhoushengmin
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

🦴 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: unreal-animation-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. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • spine-mcp

    1425sd
    A
    license
    A
    quality
    D
    maintenance
    Local MCP server for automating Spine projects via the official CLI, enabling AI tools to inspect, export, import, and add animations to .spine files.
    16
    15
    11
    Apache 2.0

  • unreal-animation-mcp

    tumourlove
    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

  • spine-mcp

    yb901104-wq
    F
    license
    B
    quality
    C
    maintenance
    MCP server for reading, validating, and modifying Spine 4.1.24 JSON animation files, with tools for animation timeline editing, validation, preview, and agent integration.
    36
    -

  • Houdini MCP

    OtakuSquirrel
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to directly control SideFX Houdini, including creating nodes, setting parameters, executing Python, capturing viewports, and rendering frames, via 57 MCP tools.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhoushengmin/spine-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server