SVG Converter

You run a dedicated SVG conversion service powered by FastMCP that converts SVG files into high-quality raster images and icons. It prioritizes accurate rendering, especially for Chinese text, and exposes flexible engine choices so you can balance quality and compatibility while serving client applications efficiently.

How to use

You expose an MCP server that listens to client requests and performs SVG transformations. The server is driven through a local, inline Python process, so your MCP client can start it and send conversion tasks using the provided tool functions.

How to install

Prerequisites: you need Python installed on your system. You will install the MCP server package from its source repository and then install optional dependencies for the best rendering quality.

# Install the MCP server directly from the source
pip install git+https://github.com/RusianHu/svg-converter-tools-mcp.git -i https://pypi.tuna.tsinghua.edu.cn/simple/

# Install the full feature set with all optional dependencies
pip install "git+https://github.com/RusianHu/svg-converter-tools-mcp.git[full]" -i https://pypi.tuna.tsinghua.edu.cn/simple/

Optional dependencies can be installed to improve rendering quality and compatibility.

# Cairo-based high-quality rendering (recommended)
pip install .[cairo] -i https://pypi.tuna.tsinghua.edu.cn/simple/

# SVGLib support (good compatibility)
pip install .[svglib] -i https://pypi.tuna.tsinghua.edu.cn/simple/

# All optional dependencies
pip install .[full] -i https://pypi.tuna.tsinghua.edu.cn/simple/

# Development environment
pip install .[dev] -i https://pypi.tuna.tsinghua.edu.cn/simple/

Cairo C library (best quality) requires extra system dependencies depending on your platform.

Configuration and runtime setup

You run the MCP server in a local process and wire it to your MCP client. The client configuration uses a standard stdio-based startup, where Python is invoked to run the MCP module.

{
  "mcpServers": {
    "svg_converter_mcp": {
      "command": "python",
      "args": ["-m", "svg_converter_mcp"],
      "disabled": false
    }
  }
}

Tools and usage there within

You gain access to a set of helper functions to perform conversions and manage engines. Use these from your MCP client to operate on SVG content and files.

Troubleshooting and notes

If you encounter issues when starting or connecting the MCP server, ensure Python is correctly installed and that the server package is installed in editable or runtime mode. Verify the startup command and the module name you invoke.

Available tools

convert_svg_file

Convert an SVG file from disk to a specified output format (png, ico, jpg) with optional width, height, and background settings.

convert_svg_string

Convert an SVG string in memory to a specified output format without writing a file.

batch_convert_svg_files

Convert multiple SVG files in a batch to a chosen output directory and format, with progress reporting.

get_converter_engine_info

Query which rendering engines are available and recommended settings for the current system.

get_svg_file_info

Analyze an SVG file to determine dimensions and conversion guidance.

get_svg_string_info

Analyze an SVG content string to determine features that affect rendering and engine choice.