Image to SVG converter & MCP server

image2svg-mcp: an image to SVG converter MCP server for AI agents

image2svg-mcp is a free, open-source (Apache 2.0) MCP server that converts raster images (PNG, JPG, WEBP, TIFF) to scalable SVG vector graphics. Add it to Claude Code, Claude Desktop, Cursor, or any other MCP client and your assistant gets a convert_image_to_svg tool, the same conversion this page does, to use when a task needs a vector: a generated logo, a sketch, a batch of icons.

It runs on your own machine with the engine behind the converter above. Other hosted conversion APIs charge per image and need a key; this needs neither, and your images stay on your computer.

This page also registers convert_image_to_svg as a WebMCP tool (Chrome origin trial), so AI agents running in the browser can convert images on this page without a server.

Install uv first

Every setup below starts the server with uvx, which comes with uv, the Python package manager from Astral. On first run, uvx downloads image2svg-mcp into its own environment.

pip install uv

Install in Claude Code

claude mcp add image2svg --scope user -- uvx image2svg-mcp

To let it read local images, allow a directory:

claude mcp add image2svg --scope user -- uvx image2svg-mcp --allow-local-files-path /home/user/images

Install in other MCP clients

The server runs with uvx image2svg-mcp (bundled with uv), so any MCP client can use it. Pick yours:

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

code --add-mcp '{"name":"image2svg","command":"uvx","args":["image2svg-mcp"]}'

{
  "servers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

codex mcp add image2svg -- uvx image2svg-mcp

Run with Docker

The server can also run as an HTTP service:

docker run -p 8000:8000 ghcr.io/botmonster/image2svg-mcp
claude mcp add image2svg --transport http --scope user http://localhost:8000/mcp

What you can ask your AI agent

• “Generate a logo with a blue circle and a white star, then convert it to SVG using binary colormode for crisp edges.”
• “Convert this image to a simplified SVG with low color precision for a minimalist poster look: https://example.com/photo.png"
• “Convert this local file to SVG: file://logo.png” (with local file access enabled)

Conversion parameters

The convert_image_to_svg tool accepts an image as base64 data or a URL, plus the same vectorization parameters as the sliders above. Dial in the settings visually on this page, then reuse them in your prompts.

Source and docs: GitHub · PyPI · Docker image