Allyson

- Generate animated SVG from a local file— Describe the motion you want and provide source and output paths togenerate_svg_animation.
- Transform static logos into animated components— Supply a logo file and a prompt like “pulse gently” to produce a glowing, animated version.
- Create custom motion effects from images— Use a natural-language prompt to add bouncing, spinning, waving, or other animations to any supported image.

Allyson MCP Server- AI-powered animation generator that transforms static files into animated SVG components using the Model Context Protocol (MCP).

allyson-mcp [options] Options: --api-key <key> Your Allyson API key (required) --help Show help message Examples: allyson-mcp --api-key your-api-key-here API_KEY=your-key allyson-mcp

You can also set your API key as an environment variable:

export API_KEY=your-api-key-here allyson-mcp

- 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

Generates an animated SVG component from a source file and animation prompt.

- 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"

- Example: "/path/to/my-icon.svg"

- Example: "/path/to/animated-component.tsx"

{ "tool": "generate_svg_animation", "arguments": { "prompt": "Make the logo glow and pulse gently", "svg_path": "/Users/john/Desktop/company-logo.svg", "output_path": "/Users/john/project/src/components/AnimatedLogo.tsx" } }

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)

{ "mcpServers": { "allyson": { "command": "npx", "args": ["allyson-mcp", "--api-key", "YOUR_API_KEY"] } } }

# Start the server allyson-mcp --api-key your-api-key # The AI assistant can now use the tool: # "Please animate this logo to have a subtle glow effect" # File: /Users/john/logo.svg → /Users/john/animated-logo.tsx

- 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

# Solution: Provide API key via flag or environment variable allyson-mcp --api-key YOUR_KEY # or export API_KEY=YOUR_KEY && allyson-mcp

# Make sure to use absolute paths ❌ Wrong: ./image.svg ✅ Correct: /Users/username/project/image.svg

"Cannot connect to animation API server" Error

- Check your internet connection
- Verify your API key is valid
- Ensure the Allyson service is accessible

# Make the file executable if needed chmod +x node_modules/allyson-mcp/index.js

For debugging, you can check the server logs which are output to stderr:

allyson-mcp --api-key YOUR_KEY 2> debug.log

- Node.js: Version 18.0.0 or higher
- API Key: Valid Allyson API key
- Internet Connection: Required for API communication

We welcome contributions! Please see our contributing guidelines for more details.

Apache-2.0 License - see LICENSE file for details.

- Model Context Protocol
- Allyson Website
- Issue Tracker

- Documentation: Check this README and inline help (--help)
- Issues: Report bugs on ourGitHub Issues

Render chart images from JSON configs with six themes, ten marks, PNG/SVG output.