Skip to main content
Glama
tjboudreaux

svg-generator-mcp

by tjboudreaux
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

SVG Generator

Generate SVGs from text prompts or convert raster images to SVG using the Quiver AI API.

Works as a cross-platform AI agent skill (Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf) and as an MCP server (Claude Code, Codex, Cursor, Cline, Roo Code, Claude Desktop).

Prerequisites

Get an API key from Quiver AI and set it as an environment variable:

export QUIVER_API_KEY="your-api-key-here"

Related MCP server: SVG Maker MCP Server

Installation

Claude Code (Plugin)

claude plugin add /path/to/cc-skills-svg-generator

This installs both the skill (prompt-driven usage) and the MCP server (tool-based usage).

Claude Code (MCP Server only)

claude mcp add svg-generator -- uvx svg-generator-mcp

Claude Code (Skill only)

Copy or symlink the svg-generator/ directory into your skills folder:

# User-level (all projects)
cp -r svg-generator ~/.claude/skills/svg-generator

# Project-level (this project only)
mkdir -p .claude/skills
cp -r svg-generator .claude/skills/svg-generator

OpenAI Codex CLI

As a skill:

mkdir -p .agents/skills
cp -r svg-generator .agents/skills/svg-generator

As an MCP server — add to ~/.codex/config.toml:

[mcp_servers.svg-generator]
command = "uvx"
args = ["svg-generator-mcp"]
enabled = true

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "svg-generator": {
      "command": "uvx",
      "args": ["svg-generator-mcp"],
      "env": {
        "QUIVER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline / Roo Code

Add via the MCP settings panel, or add to the MCP config file:

{
  "mcpServers": {
    "svg-generator": {
      "command": "uvx",
      "args": ["svg-generator-mcp"],
      "env": {
        "QUIVER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "svg-generator": {
      "command": "uvx",
      "args": ["svg-generator-mcp"],
      "env": {
        "QUIVER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Install from PyPI

pip install svg-generator-mcp

Or run directly with uvx:

uvx svg-generator-mcp

MCP Server Tools

The MCP server exposes two tools:

generate_svg

Generate SVGs from text descriptions.

Parameter

Type

Required

Description

prompt

string

Yes

Text description of the SVG

output

string

No

Output filename

output_dir

string

No

Output directory (default: .)

instructions

string

No

Style guidance

references

string[]

No

Reference image URLs (max 4)

n

int

No

Number of SVGs, 1-16 (default: 1)

temperature

float

No

Randomness 0-2 (default: 1)

model

string

No

Model name (default: arrow-preview)

timeout

int

No

Request timeout in seconds (default: 600)

vectorize_svg

Convert raster images (PNG, JPG, WebP) to SVG.

Parameter

Type

Required

Description

image

string

Yes

Local file path or URL

output

string

No

Output filename

output_dir

string

No

Output directory (default: .)

auto_crop

bool

No

Enable automatic cropping

target_size

int

No

Target size in pixels (128-4096)

n

int

No

Number of SVGs, 1-16 (default: 1)

temperature

float

No

Randomness 0-2 (default: 1)

model

string

No

Model name (default: arrow-preview)

timeout

int

No

Request timeout in seconds (default: 600)

CLI Scripts

The skill also includes standalone CLI scripts:

# Text-to-SVG
python3 svg-generator/scripts/generate_svg.py \
  --prompt "a minimalist mountain logo" \
  --output mountain.svg

# Image-to-SVG
python3 svg-generator/scripts/vectorize_svg.py \
  --image photo.png \
  --output vectorized.svg

See svg-generator/SKILL.md for full CLI documentation.

Project Structure

.
├── .claude-plugin/
│   └── plugin.json           # Claude Code plugin manifest
├── .mcp.json                 # Project-level MCP config
├── svg-generator/
│   ├── SKILL.md              # Cross-platform agent skill
│   ├── references/
│   │   └── api_reference.md
│   └── scripts/
│       ├── generate_svg.py
│       └── vectorize_svg.py
├── src/
│   └── svg_generator_mcp/
│       ├── __init__.py
│       └── server.py         # MCP server implementation
├── pyproject.toml            # Python package config
└── svg-generator.skill       # Packaged skill (zip)

How It Works

Layer

What

Reaches

Skill (SKILL.md)

Instructions + CLI scripts the AI follows

Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, GitHub Copilot

MCP Server

Structured tool API over Model Context Protocol

Claude Code, Claude Desktop, Codex CLI, Cursor, Cline, Roo Code

Plugin (.claude-plugin/)

Bundles skill + MCP server config

Claude Code

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers