The Allyson MCP Server is an AI-powered tool that transforms static images into animated SVG components using the Model Context Protocol (MCP).
Key capabilities:
Generate animated SVGs from static files (PNG, JPG, SVG)
Define animations using natural language prompts
Process local files using absolute paths
Save animated components to specified locations (e.g., in TSX format)
Integrate with MCP-compatible AI assistants and tools like Claude Desktop and Cursor IDE
Provide secure handling of API keys with HTTPS communication
Runs on Node.js version 18.0.0 or higher, utilizing it as the runtime environment for the animation generation server.
Available as an npm package (allyson-mcp) that can be installed and run using npm or npx commands.
Enables AI-powered transformation of static SVG files into animated SVG components with custom animation effects like glowing, pulsing, spinning, and bouncing.
Allyson MCP Server
Allyson MCP Server - AI-powered animation generator that transforms static files into animated SVG components using the Model Context Protocol (MCP).
🚀 Quick Start
Install and Run with npx
Related MCP server: SVG to PNG MCP Server
🔧 Configuration
Command Line Options
Environment Variables
You can also set your API key as an environment variable:
🎯 Features
AI-Powered Animation Generation: Transform static images into animated SVG components
MCP Protocol Compatible: Works with any MCP-compatible AI assistant or tool
File Upload Support: Supports various image formats (PNG, JPG, SVG, etc.)
Custom Animation Prompts: Describe exactly what animation you want
Local File Processing: Reads files from your local filesystem
Automatic Output Generation: Saves animated components to specified paths
🛠 Available Tools
generate_svg_animation
Generates an animated SVG component from a source file and animation prompt.
Parameters:
prompt(string, required): Description of the animation to generateExample: "Make the character wave their hand"
Example: "Add bouncing motion to the ball"
Example: "Create a spinning effect for the logo"
svg_path(string, required): Absolute path to the source fileExample: "/path/to/my-icon.svg"
output_path(string, required): Absolute path where to save the animated componentExample: "/path/to/animated-component.tsx"
Example Usage in MCP Client:
🔌 Integration with AI Assistants
This MCP server is designed to work with AI assistants that support the Model Context Protocol, such as:
Claude Desktop (with MCP configuration)
Cursor IDE (with MCP integration)
Custom AI Applications (using MCP SDK)
MCP Configuration
📝 Examples
Basic Animation Generation
🔐 Security
API Key Protection: Your API key is securely transmitted to the Allyson service
Local File Access: Only reads files you explicitly specify
No Data Storage: Files are processed and not stored on external servers
HTTPS Communication: All API communications use secure HTTPS
🐛 Troubleshooting
Common Issues
"API key is required" Error
"File not found" Error
"Cannot connect to animation API server" Error
Check your internet connection
Verify your API key is valid
Ensure the Allyson service is accessible
Permission Issues
Debug Mode
For debugging, you can check the server logs which are output to stderr:
📋 Requirements
Node.js: Version 18.0.0 or higher
API Key: Valid Allyson API key
Internet Connection: Required for API communication
🤝 Contributing
We welcome contributions! Please see our contributing guidelines for more details.
📄 License
Apache-2.0 License - see LICENSE file for details.
🔗 Links
📞 Support
Documentation: Check this README and inline help (
--help)Issues: Report bugs on our GitHub Issues