# 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