Spine2d Animation MCP

🚀 PSDファイルを使用したSPINE2Dアニメーション作成のためのMCPサーバー

このモデルコンテキストプロトコル（MCP）サーバーは、PSDキャラクターファイルから自然言語記述を使ってSPINE2Dアニメーションを作成するツールを提供します。

🚀 クイックスタート

SPINE2DアニメーションMCPサーバーを使えば、以下のことができます。

1. PSDキャラクターファイルをインポートする。
2. キャラクターを自動的にバインドする。
3. 自然言語記述を使ってアニメーションを生成する。
4. アニメーションをプレビューする。
5. 様々な形式でアニメーションをエクスポートする。

✨ 主な機能

• 自然言語記述によるSPINE2Dアニメーション生成
• PSDファイルの自動バインド
• アニメーションのプレビューとエクスポート

📦 インストール

前提条件

• Python 3.6+
• 必要なPythonパッケージ（自動インストール）：
  • Flask
  • Pydantic
  • Pillow
  • PSD-Tools
  • OpenAI（自然言語処理用）
  • Requests
  • Python-dotenv

インストール手順

1. このリポジトリをクローンします。
2. インストールスクリプトを実行します。

./install.sh

インストールスクリプトは以下のことを行います。

• 必要なストレージディレクトリを作成します。
• Pythonの依存関係をインストールします。
• VS Code用にMCP設定を構成します。
• オプションでClaude Desktop用にMCP設定を構成します。

💻 使用例

基本的な使用法

インストールが完了したら、VS Codeと/またはClaudeを再起動します。その後、MCPサーバーを通じて以下のツールを使用できます。

PSDキャラクターのインポート

PSDファイルをアップロードして処理します。

用法： "将我的角色从character.psd导入"

パラメータ：

• file_path：PSDファイルのパス

キャラクターの設定

インポートされたキャラクターを自動的にバインドします。

用法： "为我的角色设置 rigs"

パラメータ：

• character_id：import_psdから取得したキャラクターID

アニメーションの生成

テキスト記述に基づいてアニメーションを作成します。

用法： "为我的角色创建一个开心的挥手动画"
用法： "让我的角色兴奋地跳跃"
用法： "将我的角色吓跑，并带有闪烁效果"

パラメータ：

• character_id：キャラクターID
• description：アニメーションの記述（例：「挥手」）

アニメーションのプレビュー

アニメーションのプレビューを取得します。

用法： "显示我挥手动画的预览"

パラメータ：

• character_id：キャラクターID
• animation_id：アニメーションID

アニメーションのエクスポート

最終的なアニメーションをエクスポートします。

用法： "将跳跃动画作为 GIF 导出"

パラメータ：

• character_id：キャラクターID
• animation_id：アニメーションID
• format：エクスポート形式（json、png、gif）

📚 ドキュメント

プロジェクト構造

spine2d-animation-mcp/
├── README.md             # このファイル
├── requirements.txt      # Pythonの依存関係
├── install.sh            # インストールスクリプト
├── src/
│   ├── main.py           # エントリーポイント
│   ├── server.py         # MCPサーバーの実装
│   ├── psd_parser.py     # PSD解析モジュール
│   ├── animation_generator.py  # アニメーション生成モジュール
│   └── spine2d_integration.py  # SPINE2D統合モジュール
└── storage/              # インストール時に作成
    ├── characters/       # インポートされたキャラクターデータ
    ├── animations/       # 生成されたアニメーション
    ├── rigs/             # キャラクターのリグ
    └── exports/          # エクスポートされたアニメーション

動作原理

1. PSDインポート：サーバーがPSDファイルを解析し、レイヤーを抽出してキャラクター構造に整理します。
2. キャラクターバインド：サーバーがキャラクター構造を分析し、自動的に骨、IK制約、スキンアタッチメントを作成します。
3. アニメーション生成：自然言語記述が解析され、アニメーションのタイプ、感情、強度が抽出されます。その後、これらの情報がアニメーションテンプレートに適用されます。
4. アニメーションプレビュー：サーバーがアニメーションのGIF形式のプレビューを生成します。
5. アニメーションエクスポート：サーバーが要求された形式（JSON、PNG、またはGIF）でアニメーションをエクスポートします。

制限事項

1. 自動バインドシステムはレイヤー名と構造に基づいているため、最適な結果を得るには特定の命名規則が必要になる場合があります。
2. アニメーションテンプレートは事前定義されているため、複雑なカスタムアニメーションには手動調整が必要になる場合があります。
3. この実装では自然言語処理が簡略化されているため、複雑な記述のすべての微妙なニュアンスを捉えられない場合があります。

将来の改善点

1. より高度なLLM統合を使用して自然言語理解を向上させる。
2. 画像分析に基づく、より複雑な自動バインドと骨の配置。
3. アニメーションテンプレートライブラリを拡張する。
4. リアルタイムプレビューレンダリング。
5. より多くのエクスポート形式とオプション。

関連ドキュメント

• アニメーション作成ガイド - PSDファイルのみを使用してアニメーションを最初から作成する完全なガイド
• SPINE2D統合ガイド - SPINE2Dを構成して使用するための設定