SPINE2D Animation MCP Server

Overview

基本能力

产品定位

SPINE2D Animation MCP Server 是一个动画生成工具，专注于从PSD文件创建SPINE2D动画，并通过自然语言描述简化动画生成过程。

核心功能

导入PSD角色文件：解析PSD文件，提取图层并组织成角色结构。
自动角色绑定：分析角色结构，自动创建骨骼、IK约束和皮肤附件。
生成动画：通过自然语言描述生成动画，支持多种情感和动作。
预览动画：生成GIF格式的动画预览。
导出动画：支持导出为JSON、PNG或GIF格式。

适用场景

游戏开发：快速生成角色动画，减少手动绑定和动画制作时间。
动画制作：通过自然语言描述快速创建复杂动画。
教育：用于教学和演示动画生成的基本原理。

工具列表

Import PSD Character：导入并处理PSD文件。
Setup Character：自动绑定已导入的角色。
Generate Animation：通过自然语言描述生成动画。
Preview Animation：预览生成的动画。
Export Animation：导出动画到指定格式。

常见问题解答

自动绑定系统的限制：基于图层名称和结构，可能需要特定的命名约定以获得最佳效果。
动画模板的限制：预定义的动画模板可能无法满足复杂的自定义动画需求。
自然语言处理的限制：简化的自然语言处理可能无法捕捉复杂描述的所有细节。

使用教程

使用依赖

Python 3.6+
所需Python包（自动安装）：
Flask
Pydantic
Pillow
PSD-Tools
OpenAI（用于自然语言处理）
Requests
Python-dotenv

安装教程

克隆仓库
运行安装脚本：

./install.sh

安装脚本将： - 创建必要的存储目录 - 安装Python依赖 - 配置VS Code的MCP设置 - 可选配置Claude Desktop的MCP设置

调试方式

安装完成后，重启VS Code和/或Claude，即可通过MCP服务器使用上述工具。

项目结构

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/          # 导出的动画

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。