svg MCP

svg mcp

一个MCP服务器，它提供了一个持久的SVG画布，您可以通过简单的工具调用进行绘制。每个工具都会将当前画布返回为PNG图像，这样您就可以在每个步骤后直观地检查进度。

特性

• 持久内存画布——元素在工具调用中累积
• 用于矩形、圆形、椭圆形、直线、折线、多边形、路径和文本的形状工具
• draw_raw_svg 任意SVG片段的转义阴影
• add_def 用于渐变、图案、剪辑路径和过滤器
• 导出到 可缩放矢量图形 或 便携式网络图形 （具有可配置的分辨率比例）
• 每个工具都将当前画布作为PNG预览返回

需求

• Python≥3.14
• 开罗 系统库（由使用 cairosvg 用于PNG渲染）

在Ubuntu/Debian上：

sudo apt install libcairo2

在macOS（Homebrew）上：

brew install cairo

Python依赖关系：

pip install cairosvg "mcp[cli]"

运行服务器

服务器通过以下方式进行通信 标准 （标准MCP传输）：

python main.py

MCP客户端配置

使用Nix（推荐）

如果你有 尼克斯 已安装，不需要本地签出。使用 nix run 命令--Nix将自动获取、构建和缓存所有内容。

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "svg-mcp": {
      "command": "nix",
      "args": ["run", "github:datakurre/svg-mcp"]
    }
  }
}

VS代码(settings.json)

{
  "mcp": {
    "servers": {
      "svg-mcp": {
        "type": "stdio",
        "command": "nix",
        "args": ["run", "github:datakurre/svg-mcp"]
      }
    }
  }
}

没有Nix（本地Python）

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "svg-mcp": {
      "command": "python",
      "args": ["/path/to/svg-mcp/main.py"]
    }
  }
}

VS代码(settings.json)

{
  "mcp": {
    "servers": {
      "svg-mcp": {
        "type": "stdio",
        "command": "python",
        "args": ["/path/to/svg-mcp/main.py"]
      }
    }
  }
}

替换 /path/to/svg-mcp/main.py 机器上的绝对路径。

工具参考

画布管理

Z顺序

撤消/恢复

绘图

所有绘图工具都接受可选 element_id 参数。如果省略，则会自动生成一个唯一的ID。

stroke_dasharray 接受任何SVG破折号模式，例如。 "5,3" （5px破折号，3px间隙）或 "10,5,2,5" （长短交替）。

定义

示例——定义一个线性梯度并使用它：

add_def('

')
draw_rect(x=0, y=0, width=800, height=600, fill="url(#sky)")

出口

示例会话

create_canvas(width=600, height=400, background="#1a1a2e")
draw_circle(cx=300, cy=200, r=120, fill="#e94560", stroke="white", stroke_width=3)
draw_text(x=300, y=210, text="Hello!", font_size=48, fill="white", text_anchor="middle")
export_png("output/hello.png", scale=2.0)

坐标系

SVG使用 左上原点 y向下增加。所有单位都是相对于中设置的画布尺寸的像素 create_canvas.