svg-tracer

SVG Tracer MCP サーバー

potrace トレースを使用してビットマップ画像（PNG、JPG、BMP、GIF、TIFF、WebP）を SVG ベクター画像に変換する MCP サーバーです。

機能

• 一般的なビットマップ形式を、クリーンな SVG ベクターパスに変換します
• 透明な PNG を自動で前処理します（アルファチャンネルを白地に黒のマスクに変換）
• トレースパラメーターをカスタマイズできます（しきい値、斑点の抑制、曲線の最適化）
• アイコン（例：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. 前処理する - アルファチャンネルを白地に黒のグレースケールマスクに変換して、透明度を処理します
3. トレースする - potrace を使用して、ビットマップを SVG ベクターパスに変換します
4. 拡大縮小する - 必要に応じてパスを変換グループで囲み、ターゲットサイズに合わせます
5. 出力する - SVG をディスクに書き込み、メタデータとともに SVG 文字列を返します

対応形式

• PNG（アルファチャンネル付きの透明な 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