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
🔧 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 generate- Example: "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 file- Example: "/path/to/my-icon.svg"
output_path
(string, required): Absolute path where to save the animated component- Example: "/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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
AI-powered animation generator that transforms static images into animated SVG components using the Model Context Protocol, allowing users to create animations through natural language prompts.
Related MCP Servers
- -securityAlicense-qualityA server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.Last updated -6PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides tools for converting SVG code to high-quality PNG and JPG images with detailed customization options.Last updated -234JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that converts SVG code to PNG images, offering two conversion methods (CairoSVG and Inkscape) with support for custom working directories.Last updated -2Python
- AsecurityFlicenseAqualityAn MCP server that enables AI models to generate precise geometric images by providing Asymptote code, supporting both SVG and PNG output formats.Last updated -15JavaScript