home / mcp / allyson mcp server

Allyson MCP Server

Provides AI-powered SVG animation generation by reading local files and exporting animated components through MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

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

Allyson MCP Server is a node-based service that lets you generate animated SVG components from static assets using the Model Context Protocol. It enables AI-powered animation workflows by exposing a simple MCP-compatible interface you can invoke from your preferred MCP client or automation tooling.

How to use

You integrate Allyson MCP Server with an MCP client to request animated SVG components. Start the server with your API key and then issue a tool call from your AI assistant or automation workflow. The server will read your local source files, generate the requested animation, and save the resulting component to the path you specify.

How to install

Prerequisites: Node.js version 18.0.0 or higher, and a valid Allyson API key.

Install and run using the quick start method with npx.

npx allyson-mcp --api-key YOUR_API_KEY

Configuration

You can supply your API key in two ways: via the command line or as an environment variable. The command-line option is required for a direct run, while the environment variable provides a convenient alternative in shells and automation.

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

Security

API keys are transmitted securely to the Allyson service over HTTPS. The server reads only the files you specify and does not store your data externally.

Examples

Basic animation generation flow: start the server and then instruct your MCP client to animate a file.

# Start the server
allyson-mcp --api-key your-api-key-here

# Then an MCP client can request an animation for a source file and specify an output path
# Example usage is provided by your MCP client integration, not shown here

Troubleshooting

If you encounter issues, verify that your API key is correct, the server can access the local source file you specified, and your network connection to the Allyson API is functional.

# Common checks
export API_KEY=your-key-here
npx allyson-mcp --api-key $API_KEY 2>&1 | tee debug.log

Notes

The server supports MCP-compatible clients and can process common image formats. You can configure the client to call the generate_svg_animation tool with a text prompt, an absolute path to the source SVG, and an absolute path where the animated component should be saved.

Available tools

generate_svg_animation

Generates an animated SVG component from a source file using an animation prompt. Parameters include prompt (description of the animation), svg_path (absolute path to the source file), and output_path (absolute path to save the animated component).