botmonster/image2svg-mcp

An MCP server that converts raster images (PNG, JPG, WEBP) to scalable SVG vector graphics.
Features
- Accepts images as **base64-encoded data** or **URL**
- Supports PNG, JPG, JPEG, WEBP, TIFF, and other common raster formats
- Full control over vectorization parameters (color precision, speckle filtering, tracing mode, etc.)
- Handles data:image/...;base64, URI prefixes automatically
- Streams URL downloads with a 5 MB size limit
- Optional file:// URL support for local images (opt-in via --allow-local-files-path)
Usage
To see it in action check converting image to svg online.
Claude Code & Claude Desktop
Add to your settings.json:
for **Claude Code** add using command line:
with access to local files:
Docker
Run as an HTTP server:
With local file access:
This enables prompts like:
> Convert this local file to SVG: file://logo.png
Only files inside the specified directory (and its subdirectories) are accessible. Paths are normalized to prevent directory traversal. Without this flag, file:// URLs are rejected.
Example Prompts
Here are some examples of what you can tell an LLM to do with this tool:
1. Simple image-to-SVG conversion
> Generate an image of a sunset over mountains, then convert it to SVG.
The LLM will generate a raster image and then use the convert_image_to_svg tool with default settings to produce a clean vector version.
2. Fine-tuned conversion with specific parameters
> Create a logo with a blue circle and a white star inside it. Now convert it to SVG using binary colormode for crisp edges and set filter_speckle to 10 to remove noise.
This uses colormode: "binary" for black/white line art style output, which works great for logos and icons. The higher filter_speckle value removes small artifacts.
3. Convert from URL with minimalist style
> Convert this image to a simplified SVG with low color precision for a minimalist poster look: https://example.com/photo.png
Using color_precision: 3 reduces the number of colors dramatically, producing an artistic posterized vector effect. Great for stylized illustrations.
4. Convert a base64 image directly
> Convert this base64 image to SVG: iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAO0lEQVR4nGP8z8Dwn4EIwESMIqwKGRn+MzBisYQJXRE2NopCbKYgi5Huxv8MjBiSyGJMuCTQNTJSPRwBCjYOD5JU5rIAAAAASUVORK5CYII=
This is a 10x10 red square with a blue circle in the middle. Useful for testing the tool with inline image data — no URL needed.
Tool Parameters
| Parameter | Type | Default | Range | Description |
|---|---|---|---|---|
| image_base64 | string | - | - | Base64-encoded image data. Provide this OR image_url. |
| image_url | string | - | - | URL to fetch the image from (http://, https://, or file:// when enabled). Provide this OR image_base64. |
| colormode | string | "color" | color, binary | Full color or black/white line art |