knowledge-base/architecture.md

Any2SVG Architecture

Overview

Any2SVG is a Gradio 6 application that converts raster images to SVG vector graphics. It's designed to work both as a standalone web application and as an MCP (Model Context Protocol) server for AI agent integration.

DNA Architecture

The project follows the DNA architecture pattern:

any-to-svg/
├── app.py                    # Main Gradio application
├── dna/
│   ├── atoms/               # Core utilities
│   │   └── vectorizer.py    # Low-level vtracer wrapper
│   ├── molecules/           # Composite components
│   │   └── mcp_handler.py   # MCP request processing
│   └── proteins/            # High-level orchestration
├── knowledge-base/          # Documentation
└── output/                  # Generated SVG files

Components

Atoms Layer

• vectorizer.py: Core vectorization using vtracer library
  • VectorizerConfig: Configuration dataclass
  • image_to_svg_string(): Convert to SVG string
  • image_to_svg_file(): Convert and save to file

Molecules Layer

• mcp_handler.py: MCP integration
  • process_mcp_request(): Handle MCP tool calls
  • get_output_directory(): Manage output paths

Application Layer

• app.py: Gradio interface and MCP server
  • Web UI with configurable parameters
  • MCP tool endpoint at /gradio_api/mcp/sse

MCP Integration

The application exposes an MCP tool image_to_svg that:

1. Accepts image input (URL or base64)
2. Converts to SVG using vtracer
3. Saves to configured output directory
4. Returns file path and SVG content

Security Considerations

• Input validation on all image uploads
• Sanitized file paths for output
• Environment variable protection for sensitive config
• No arbitrary code execution