SVG生成器

SVG生成器是一款基于Quiver AI API的工具,能够通过文本提示生成SVG图像或将光栅图像转换为SVG格式,支持多种开发平台和工具。

  • by tjboudreaux
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tjboudreaux/cc-skills-svg-generator

使用说明

SVG生成器

根据文本提示生成SVG,或使用 Quiver AI API

作为一个 跨平台AI代理技能 (Claude Code、Codex CLI、Gemini CLI、Cursor、Windsurf) MCP服务器 (克劳德代码、Codex、Cursor、Cline、Roo代码、克劳德桌面)。

先决条件

从获取API密钥 Quiver AI 并将其设置为环境变量:

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

安装

克劳德代码(插件)

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

这将安装技能(提示驱动使用)和MCP服务器(基于工具的使用)。

克劳德代码(仅限MCP服务器)

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

克劳德代码(仅限技能)

复制或符号链接 svg-generator/ 将目录放入技能文件夹:

# 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命令行界面

作为一种技能:

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

作为MCP服务器 --添加到 ~/.codex/config.toml:

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

光标

添加 .cursor/mcp.json 在您的项目中:

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

Cline/Roo代码

通过MCP设置面板添加,或添加到MCP配置文件中:

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

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

从PyPI安装

pip install svg-generator-mcp

或者直接与 uvx:

uvx svg-generator-mcp

MCP服务器工具

MCP服务器公开了两个工具:

generate_svg

根据文本描述生成SVG。

参数 类型 必填 说明
prompt string 是 SVG的文本描述
output string 否 输出文件名
output_dir string 否 输出目录(默认: .)
instructions string 否 样式指南
references string[] 否 引用图像URL(最多4个)
n int 否 SVG数量,1-16(默认值:1)
temperature float 否 随机性0-2(默认值:1)
model string 否 型号名称(默认值: arrow-preview)
timeout int 否 请求超时(秒)(默认值:600)

vectorize_svg

将光栅图像(PNG、JPG、WebP)转换为SVG。

参数 类型 必填 说明
image string 是 本地文件路径或URL
output string 否 输出文件名
output_dir string 否 输出目录(默认: .)
auto_crop bool 否 启用自动裁剪
target_size int 否 目标像素大小(128-4096)
n int 否 SVG数量,1-16(默认值:1)
temperature float 否 随机性0-2(默认值:1)
model string 否 型号名称(默认值: arrow-preview)
timeout int 否 请求超时(秒)(默认值:600)

CLI脚本

该技能还包括独立CLI脚本:

# 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

看 svg-generator/SKILL.md 获取完整的CLI文档。

项目结构

.
├── .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)

运作原理

层 内容 到达
技能 (SKILL.md) AI遵循的指令+CLI脚本 Claude Code、Codex CLI、Gemini CLI、Cursor、Windsurf、GitHub Copilot
MCP服务器 基于模型上下文协议的结构化工具API Claude Code、Claude Desktop、Codex CLI、Cursor、Cline、Roo Code
插件 (.claude-plugin/) 捆绑技能+MCP服务器配置 克劳德代码

许可证

麻省理工学院