Glaxnimate-compatible SVG animation MCP

This local MCP server inspects SVG artwork and adds SMIL keyframes to elements with stable IDs. It is designed for an LLM workflow: generate structured SVG, inspect its groups, add motion, then open the result in Glaxnimate or use it directly on the web.

Glaxnimate has a headless Python API in its source tree, but the published Python package is currently Windows-only. This server therefore uses portable SVG animation primitives instead of pretending to control a Glaxnimate installation that is not available. The generated SVG files remain editable in Glaxnimate.

Tools

• glaxnimate_inspect_svg lists SVG IDs and the elements they refer to.

• glaxnimate_animate_svg adds SMIL animation for translation, rotation, scale, opacity, path morphs, and stroke-dashoffset.

glaxnimate_animate_svg returns both an animated SVG and the original SVG for reduced-motion handling. Use the static version when the host page detects prefers-reduced-motion: reduce.

Related MCP server: text2animate

Install

This project requires Python 3.11 or newer. From a checkout of the repository, create a virtual environment and install the package:

python -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install .

Configure your MCP client to launch glaxnimate-mcp over stdio. For clients that accept a JSON configuration, the command is:

{
  "command": "glaxnimate-mcp"
}

Verification

Run the unit tests from the repository root:

PYTHONPATH=src python -m unittest discover -s tests -v

License

MIT