svg-tracer

SVG Tracer MCP Server

一个 MCP 服务，可使用 potrace 描摹将位图图像（PNG、JPG、BMP、GIF、TIFF、WebP）转换为 SVG 矢量图形。

功能

• 将常见位图格式转换为简洁的 SVG 矢量路径
• 自动预处理透明 PNG（将 alpha 通道转换为黑底白色蒙版）
• 可自定义描摹参数（阈值、斑点抑制、曲线优化）
• 支持缩放到目标尺寸以生成图标（例如 50x50 的 Dewey 图标）
• 支持自定义填充颜色和背景
• 默认使用本地文件系统（读取输入文件并将输出写入磁盘）

快速开始

使用 npx

{
  "mcpServers": {
    "svg-tracer": {
      "command": "npx",
      "args": ["-y", "@pulsemcp/svg-tracer-mcp-server"]
    }
  }
}

手动设置

git clone https://github.com/pulsemcp/mcp-servers.git
cd mcp-servers/productionized/svg-tracer
npm install
npm run build
npm start

工具

trace_bitmap_to_svg

使用 potrace 描摹将位图图像转换为 SVG 矢量图形。

参数：

参数	类型	必填	说明
input_path	string	是	输入位图图像文件的绝对路径
output_path	string	否	输出 SVG 的路径（默认为输入路径加上 .svg 扩展名）
threshold	number	否	黑白阈值 0-255（默认值：128）
turd_size	number	否	抑制不超过此像素数的斑点（默认值：2）
opt_tolerance	number	否	曲线优化容差 0-1（默认值：0.2）
color	string	否	描摹路径的填充颜色（默认值："#000000"）
background	string	否	背景颜色（默认值："transparent"）
target_width	number	否	SVG 的目标宽度（像素）
target_height	number	否	SVG 的目标高度（像素）

使用示例：

Convert /tmp/logo.png to SVG:
trace_bitmap_to_svg(input_path="/tmp/logo.png")

Create a 50x50 icon with brand color:
trace_bitmap_to_svg(
  input_path="/tmp/logo.png",
  output_path="/tmp/logo-icon.svg",
  target_width=50,
  target_height=50,
  color="#FF5733"
)

工作原理

1. 读取输入 - 加载位图图像（PNG、JPG、BMP、GIF、TIFF、WebP）
2. 预处理 - 将 alpha 通道转换为黑底白色灰度蒙版，以处理透明效果
3. 描摹 - 使用 potrace 将位图转换为 SVG 矢量路径
4. 缩放 - 可选地将路径包裹在变换组中，以适应目标尺寸
5. 输出 - 将 SVG 写入磁盘，并返回包含元数据的 SVG 字符串

支持的格式

• PNG（包括带有 alpha 通道的透明 PNG）
• JPEG / JPG
• WebP
• BMP
• GIF
• TIFF

开发

npm install
npm run build
npm run dev          # Development mode with auto-reload
npm test             # Run functional tests
npm run test:run     # Run tests once
npm run test:integration  # Run integration tests
npm run test:all     # Run all tests

许可证

MIT