Svgmaker MCP

What GenWaveLLC/svgmaker-mcp MCP server does

GenWaveLLC/svgmaker-mcp MCP server exposes SVGMaker image operations through the Model Context Protocol. An MCP client can request a new SVG from a text description, revise an existing SVG with a natural-language instruction, convert an image into scalable vector output, or remove an image background and return a transparent SVG. A raster mode is also available when a PNG is preferable to vector output.

The server is suited to design tasks performed from an AI coding or assistant client, such as creating icons, producing illustrations, refining logos, or preparing image assets. Generated images and gallery items can be previewed inline in clients that support the returned image content.

How it works

GenWaveLLC/svgmaker-mcp MCP server sends supported requests to the SVGMaker API. The main examples use generation and editing requests with parameters such as a text prompt, quality, aspect ratio, input image, and output path. Operations report progress while they run.

In local stdio mode, the process runs on the user’s machine. Local paths can be supplied for input and output, and generated files can be written to disk. This mode requires the SVGMAKER_API_KEY environment variable.

The hosted mode uses https://mcp.svgmaker.io/mcp. It authenticates through a browser login rather than a local API key. Because the hosted process cannot access the client’s filesystem, it returns hosted SVGMaker URLs instead of writing to output_path. A local image must first be uploaded through the server before it can be used by a hosted request.

Setup and configuration

The project requires Node.js 20.9.0 or newer and npm 7.0.0 or newer. It supports Linux, macOS, and Windows. Install the npm package with npx -y @genwave/svgmaker-mcp, then provide an SVGMaker API key through the environment:

SVGMAKER_API_KEY="your_api_key_here"

MCP clients can launch the package over stdio. Claude Desktop, Claude Code, Cursor, and Visual Studio Code are documented as client options. The repository also documents the hosted endpoint for clients that support remote HTTP MCP connections.

Tools and capabilities

GenWaveLLC/svgmaker-mcp MCP server documents these capabilities:

• Generate SVG artwork from text descriptions.
• Edit existing SVG files using natural-language instructions.
• Convert raster images into scalable SVG output.
• Remove backgrounds and preserve a transparent foreground result.
• Request PNG output through raster mode.
• Upload local files for use with the hosted service.
• Preview generated images and gallery items inline.
• Receive progress updates during processing.
• Use path validation for local file operations.

Limitations and notes

The local and hosted modes have different file behavior. Stdio can access local paths and save output files, while the HTTPS service cannot see the local disk and instead provides hosted results. Hosted requests that begin with a local file therefore require an upload step first.

The server depends on the SVGMaker API, so local use requires an SVGMaker API key. The repository excerpt does not specify API quotas, pricing, supported image formats, or the retention period for hosted URLs. It also does not establish compatibility with MCP clients beyond the clients documented in the README.