iflow-mcp_ampersante-spine2d-animation-mcp

# SPINE2D Animation MCP Server This Model Context Protocol (MCP) server provides tools for creating SPINE2D animations from PSD character files using natural language descriptions. ## Overview The SPINE2D Animation MCP server allows you to: 1. Import PSD character files 2. Automatically rig characters 3. Generate animations using natural language descriptions 4. Preview animations 5. Export animations in various formats ## Requirements - Python 3.6+ - Required Python packages (installed automatically): - Flask - Pydantic - Pillow - PSD-Tools - OpenAI (for natural language processing) - Requests - Python-dotenv ## Installation 1. Clone this repository 2. Run the installation script: ```bash ./install.sh ``` The installation script will: - Create necessary storage directories - Install Python dependencies - Configure MCP settings for VS Code - Optionally configure MCP settings for Claude Desktop ## Usage After installation, restart VS Code and/or Claude. You can then use the following tools through the MCP server: ### Import PSD Character Upload and process a PSD file: ``` Use: "Import my character from character.psd" ``` Parameters: - `file_path`: Path to the PSD file ### Setup Character Automatically rig a character that has been imported: ``` Use: "Set up rigging for my character" ``` Parameters: - `character_id`: Character ID from import_psd ### Generate Animation Create an animation from a text description: ``` Use: "Create a happy waving animation for my character" Use: "Make my character jump with excitement" Use: "Animate my character to run scared with sparkle effects" ``` Parameters: - `character_id`: Character ID - `description`: Animation description (e.g., "wave happily") ### Preview Animation Get a preview of the animation: ``` Use: "Show me a preview of the waving animation" ``` Parameters: - `character_id`: Character ID - `animation_id`: Animation ID ### Export Animation Export the final animation: ``` Use: "…