MCP SVG Animator
An MCP server for creating animated SVG diagrams. You can create a diagram from text input, photos of sketches and YAML specifications.
You don't normally need to use YAML; just tell Claude code what you want, upload photos of sketches, and then iterate until you've got what you want.
You can see some sample inputs and outputs on the Demo Page
File Output Configuration
By default, the MCP server does not allow writing files to your filesystem. To enable file output (SVG, PNG, or video), create a configuration file at ~/.config/mcp-svg-animator/config.yaml:
file_output:
allowed:
- path: "~/diagrams"
types: [svg, png, webm]
- path: "/tmp/svg-animator/**"
types: [svg, png]
- path: "~/projects/**/output"
types: [svg, png, webm]
Configuration options:
path: Directory where files can be written. Supports~expansion and glob patterns (*for single level,**for recursive).types: List of allowed file types (svg,png,webm).
Files in subdirectories of allowed paths are also permitted.
Features
- Create and iterate on your requirements using natural language and/or rough diagrams
- Multiple shape types - circle, rectangle, line, text, path, ellipse, group
- Connection elements - Draw lines between element centers with automatic positioning
- Text backgrounds - Auto-generate background panels behind text labels
- Path segments - Build curves with move_to, line_to, cubic_bezier, quadratic_bezier, arc
- SMIL animations - Animate attributes and transforms
- Reusable definitions - Define once, use many times
- Library imports - Share definitions across diagrams
- Relative positioning - Reference other elements' positions
- Direct file output - Write SVG directly to file, reducing token usage
- PNG export - Generate PNG previews of static diagrams
- Video export - Record animations to .webm video
Installation
pip install mcp-svg-animator
# Install Playwright browsers (for video generation)
playwright install chromium
Usage with Claude Code
Register the MCP server globally:
claude mcp add --scope user svg-animator -- python -m mcp_svg_animator
Then in any Claude Code session, ask Claude code to create animations:
"Create an animated SVG of a red circle that pulses"
See docs/usage.md for more details.
MCP Tools
You don't need to explicitly invoke these. Ask Claude Code to create the animation you describe, and it will invoke the relevant tools.
| Tool | Description |
|---|---|
create_svg_from_yaml |
Generate SVG from YAML specification. Optional output_path writes SVG to file; optional png_path generates a PNG preview. |
create_animation_video |
Record SVG animation to .webm video |
Development
# Clone the repository
git clone https://github.com/romilly/mcp-svg-animator.git
cd mcp-svg-animator
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
pip install -r requirements-test.txt
# Install Playwright browsers (for video generation)
playwright install chromium
# Run tests
pytest
# Type checking
pyright src/
Examples
See the examples/ directory for sample YAML files and generated SVGs:
demo.yaml- Basic shapesstick_figure.yaml- Static stick figurestick_figure_waving.yaml- Animated wavingcurves.yaml- Bezier curves and arcsmeeting.yaml- Two figures, one walks to meet the otherconnection_demo.svg- Architecture diagram using connection elementsballoon_friends.svg- Animated stick figures with stretching line
Acknowledgments
This project uses the following open source packages:
- MCP - Model Context Protocol SDK (MIT)
- Pydantic - Data validation (MIT)
- drawsvg - SVG generation (MIT)
- PyYAML - YAML parsing (MIT)
- Playwright - Video recording (Apache 2.0)
License
MIT
Metadata
Release files for mcp-svg-animator 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_svg_animator-0.5.0.tar.gz | 21.9 kB | Without provenance | Details for mcp_svg_animator-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_svg_animator-0.5.0-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for mcp_svg_animator-0.5.0-py2.py3-none-any.whl |
Total release size: 48.9 kB
Release files / mcp_svg_animator-0.5.0.tar.gz
| Download URL | mcp_svg_animator-0.5.0.tar.gz |
|---|---|
| Size | 21.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8ca6391826c4d155ee85a04a6b0f687a2a51cc0a103fa12af9ccc0a76e7bfff1
|
|
BLAKE2b-256 checksum How to use checksums |
affa53316bd17c1ffd64b9cedf8ffe102b6458c8d0ce784fddd266e1fab48dda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / mcp_svg_animator-0.5.0-py2.py3-none-any.whl
| Download URL | mcp_svg_animator-0.5.0-py2.py3-none-any.whl |
|---|---|
| Size | 27.0 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
11422a1d53c29a15d29f0f5ab5d95ae9f9c6754262ec8786c7ce98532c8bab48
|
|
BLAKE2b-256 checksum How to use checksums |
4192f239465594cf1aca95a82f4d59797c1f1a85f16711bcff33386dc110f5ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for mcp-svg-animator 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.