星战科技xingzhan.cloud
返回市场
二维骨骼动画MCP服务器

二维骨骼动画MCP服务器

作者：ampersante27 星标更新：2025-04-21
安装使用来源：spider==github.com

项目介绍

SPINE2D 动画 MCP 服务器

此模型上下文协议（MCP）服务器提供工具，使用自然语言描述从 PSD 角色文件创建 SPINE2D 动画。

概述

SPINE2D 动画 MCP 服务器允许您：

  1. 导入 PSD 角色文件
  2. 自动装配角色
  3. 使用自然语言描述生成动画
  4. 预览动画
  5. 以各种格式导出动画

要求

  • 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 文件路径

设置角色

自动装配已导入的角色：

使用："为我的角色设置装配"

参数：

  • 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. 使用更先进的大语言模型集成来提高自然语言理解能力
  2. 基于图像分析的骨骼放置进行更复杂的自动装配
  3. 扩展动画模板库
  4. 实时预览渲染
  5. 更多的导出格式和选项

文档