Spine2d Animation MCP

🚀 使用PSD文件創建SPINE2D動畫的MCP服務器

此模型上下文協議（MCP）服務器提供了強大工具，可依據自然語言描述，從PSD角色文件創建SPINE2D動畫，極大提升了動畫製作的效率與便捷性。

🚀 快速開始

SPINE2D動畫MCP服務器為動畫製作帶來了諸多便利，它允許您：

1. 導入PSD字符文件
2. 自動綁定角色
3. 使用自然語言描述生成動畫
4. 預覽動畫
5. 以各種格式導出動畫

✨ 主要特性

• 多功能支持：涵蓋了從PSD文件導入、角色綁定、動畫生成、預覽到導出的全流程操作。
• 自然語言交互：藉助自然語言描述即可生成動畫，降低了動畫製作的技術門檻。
• 格式豐富：支持以多種格式導出動畫，滿足不同場景的需求。

📦 安裝指南

先決條件

• Python 3.6+
• 必需的Python包（自動安裝）：
  • Flask
  • Pydantic
  • Pillow
  • PSD-Tools
  • OpenAI（用於自然語言處理）
  • Requests
  • Python-dotenv

安裝步驟

1. 克隆此倉庫
2. 運行安裝腳本：

./install.sh

安裝腳本將執行以下操作：

• 創建必要的存儲目錄
• 安裝Python依賴項
• 配置MCP設置以用於VS Code
• 可選配置MCP設置以用於Claude Desktop

💻 使用示例

安裝完成後，重新啟動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/             # 角色 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 的設置