Image to SVG — Claude Code MCP server: what it does, how to install
Converts raster graphics like PNG, JPG, or WEBP into scalable SVG vectors through LLM chats. Useful when turning screenshots, logos, and generated art into vector assets.
claude mcp add image2svg-mcp -- uvx image2svg-mcpWhat Image to SVG does
The server introduces the convert_image_to_svg tool to turn raster graphics into SVG vector paths. It accepts standard web formats including PNG, JPG, WEBP, and TIFF. You can pass inputs as base64 strings or remote URLs, and data URI headers are handled automatically.
Vectorization settings include curve smoothing modes like splines or polygons. The colormode option switches between color layers and monochrome line art. Small image noise disappears when raising filter_speckle, and color_precision sets color palette depth.
Network downloads are constrained by a 5 MB file size limit. Reading local paths using file:// fails immediately unless you specify --allow-local-files-path. Paths are normalized to stop directory traversal attacks.
What it helps with
- trace raster images into SVG vector paths
- filter out speckle noise from logos and scans
- quantize color palettes for simplified artwork
- enable local file access through an allowed directory
Example prompts for the agent
- Convert this image into a simplified vector SVG: https://example.com/photo.png
- Trace this sketch using binary colormode with filter_speckle set to 10 for clean edges.
- Convert this base64 image data into SVG using spline curves.
How to install Image to SVG
Platform CLI
claude mcp add image2svg-mcp -- uvx image2svg-mcpuvx runs the command named after the package; if the README names another one, use uvx --from image2svg-mcp <command>
Platform CLI
codex mcp add image-to-svg -- uvx image2svg-mcpuvx runs the command named after the package; if the README names another one, use uvx --from image2svg-mcp <command>
Config file
{
"mcpServers": {
"image-to-svg": {
"command": "uvx",
"args": [
"image2svg-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from image2svg-mcp <command>
Config file
{
"servers": {
"image-to-svg": {
"type": "stdio",
"command": "uvx",
"args": [
"image2svg-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from image2svg-mcp <command>
Platform CLI
gemini mcp add image-to-svg uvx image2svg-mcpuvx runs the command named after the package; if the README names another one, use uvx --from image2svg-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Image to SVG
How do I install Image to SVG in Claude Code?
Run claude mcp add image-to-svg -- uvx image2svg-mcp in your CLI. If you need local disk access, append --allow-local-files-path followed by the directory path.
What does Image to SVG do?
It converts raster images such as PNG, JPG, WEBP, and TIFF into SVG vector graphics. The tool allows configuring curve styles, color precision, and speckle removal.
Why does the server reject file:// URLs?
Local filesystem access is restricted to prevent directory traversal. You must start the server with --allow-local-files-path pointing to your image directory to allow file:// paths.
