Shapesoda
Vectorize images: PNG/JPG to SVG, PDF, EPS, DXF. Turns logos, icons and scans into clean vectors.
我該用這個嗎
品質與安全性
B
發現項目（2）
- HIGHTool poisoning patterns detected
- LOWTool description contains role marker that could confuse chat models在 open_editor 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~3,338Token（工具定義）
~6.6 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.61%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"vectorizer": {
"url": "https://shapesoda.com/mcp"
}
}
}遠端端點
https://shapesoda.com/mcpstreamable-http它能做什麼
工具清單
工具（5）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟡create_upload(filename)
Creates a one-time upload link for a local image file (valid 10 minutes). Upload the file with the returned curl command, then pass upload_id to vectorize. Only for agents whose terminal can reach shapesoda.com (Claude Code, Cursor and similar); in Claude.ai and other chat apps the sandbox cannot upload there, so call open_editor instead.
輸入結構描述
{
"type": "object",
"properties": {
"filename": {
"type": "string",
"description": "Optional file name, for reference only."
}
},
"additionalProperties": false
}🟡vectorize(image, upload_id, image_base64, image_type, quality, ...)
Use this when the user wants to convert a raster image (logo, icon, illustration, scan, screenshot; PNG, JPEG, WebP, BMP, GIF, TIFF) into a vector: SVG, PDF, EPS, DXF or a re-rendered PNG. Pass the image in exactly one way: image (a file attached to the chat message, ChatGPT), upload_id (from create_upload) or image_base64 (≤2 MB, only exact file bytes you already have as text). If none of these is available, for example an image attached in Claude.ai, call open_editor instead. Returns a download link per format, valid 24 hours (or retention_days), and the SVG inline when small. Uses 1 credit for all formats; mode=test is free and watermarked; mode=preview is a free PNG up to 1 MP whose link buys the vectors later (format=svg, 1 credit). Do not use for generating new images, editing photos or upscaling.
輸入結構描述
{
"type": "object",
"properties": {
"image": {
"type": "object",
"description": "Image file attached to the user's message in the chat (ChatGPT).",
"properties": {
"download_url": {
"type": "string"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
]
},
"upload_id": {
"type": "string",
"description": "ID returned by create_upload after the file was uploaded."
},
"image_base64": {
"type": "string",
"description": "Exact PNG/JPEG/WebP/BMP/GIF/TIFF file bytes in base64 (≤2 MB), only when you already have them as text (e.g. from reading the file in a terminal). Never transcribe an image you only see in the conversation; call open_editor instead. Use create_upload for larger files."
},
"image_type": {
"type": "string",
"enum": [
"auto",
"artwork",
"artwork_sharp",
"photo"
],
"description": "Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto."
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
],
"description": "Input quality: low for blurry/noisy/JPEG-heavy images. Default auto."
},
"colors": {
"description": "Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto.",
"anyOf": [
{
"type": "string",
"enum": [
"auto",
"unlimited"
]
},
{
"type": "integer",
"minimum": 2,
"maximum": 32
}
]
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"medium",
"high"
],
"description": "Output detail for photos. Default auto."
},
"preset": {
"type": "string",
"enum": [
"web",
"print",
"cut",
"laser",
"embroidery"
],
"description": "Settings for the job: web (default), print (PDF, shapes cut out), cut (vinyl/stickers, 8 colors), laser (2-color outlines), embroidery (12 colors, no tiny shapes)."
},
"format": {
"type": "array",
"items": {
"type": "string",
"enum": [
"svg",
"pdf",
"eps",
"dxf",
"png"
]
},
"minItems": 1,
"uniqueItems": true,
"description": "Output formats; several formats cost 1 credit together. Default: the preset's format (svg for web)."
},
"draw": {
"type": "string",
"enum": [
"fill",
"stroke",
"stroke_edges"
],
"description": "fill: filled shapes; stroke: outline of every shape; stroke_edges: only the borders between shapes, each once (no double cuts). Default from the preset."
},
"layers": {
"type": "string",
"enum": [
"stacked",
"cutouts",
"cutouts_grouped"
],
"description": "Shapes stacked on top of each other, cut out of each other, or cut out and grouped by color. Default from the preset."
},
"max_colors": {
"type": "integer",
"minimum": 2,
"maximum": 256,
"description": "Maximum number of colors (2–256). Not combined with colors or palette."
},
"palette": {
"description": "Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"minItems": 2,
"maxItems": 256
},
{
"type": "string"
}
]
},
"palette_tolerance": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "With palette: how far (CIE76 ΔE) an image color may be from a palette color to snap to it; farther colors keep their own value."
},
"min_area": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset."
},
"max_pixels": {
"type": "integer",
"minimum": 10000,
"maximum": 4200000,
"description": "Downscale the input to at most this many pixels before tracing (faster, fewer nodes)."
},
"curve_tolerance": {
"type": "number",
"minimum": 0.01,
"maximum": 10,
"description": "Curve fitting tolerance in source pixels (default ≈0.5): lower keeps more nodes. Also sets smoothness unless given."
},
"smoothness": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Contour smoothing 1–10 (higher: smoother, fewer nodes)."
},
"corners": {
"type": "string",
"enum": [
"sharp",
"smooth"
],
"description": "Keep corners sharp or round them."
},
"denoise": {
"type": "integer",
"minimum": 0,
"maximum": 3,
"description": "Noise reduction before tracing: 0 off … 3 strongest."
},
"group_by": {
"type": "string",
"enum": [
"none",
"color",
"layer"
],
"description": "Groups in the output: color (one per color) or layer (by nesting depth). SVG <g>, PDF layers, EPS blocks, DXF layers. Default: by color only for layers=cutouts_grouped (DXF always by color)."
},
"curves": {
"type": "string",
"enum": [
"all",
"lines",
"lines_arcs"
],
"description": "all: curves and lines; lines: straight segments only; lines_arcs: DXF lines and arcs, other formats as lines."
},
"stroke_width": {
"type": "number",
"minimum": 0.01,
"maximum": 100,
"description": "Stroke width; needs draw=stroke or stroke_edges. Output units, or source pixels with stroke_scaling=scale. Default: hairline."
},
"stroke_color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Stroke color #rrggbb instead of the shape color; needs draw=stroke or stroke_edges."
},
"stroke_scaling": {
"type": "string",
"enum": [
"fixed",
"scale"
],
"description": "fixed (default): width stays in output units when resized; scale: width in source pixels scales with the drawing."
},
"gap_filler": {
"type": "string",
"enum": [
"on",
"off"
],
"description": "on: an underlay in the shape colors hides light gaps between shapes. Needs draw=fill. Default off."
},
"gap_filler_width": {
"type": "number",
"minimum": 0,
"maximum": 10,
"description": "Gap filler width in source pixels (default 1). Needs gap_filler=on."
},
"aspect": {
"type": "string",
"enum": [
"fit",
"fill",
"stretch"
],
"description": "With both width and height: fit (default, whole drawing inside), fill (covers the sheet, excess cropped), stretch (exact size, distorted)."
},
"align_x": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Horizontal placement on the sheet, 0 left … 1 right (default 0.5). Needs width and height; not with aspect=stretch."
},
"align_y": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Vertical placement on the sheet, 0 top … 1 bottom (default 0.5). Needs width and height; not with aspect=stretch."
},
"scale": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Output size as a multiple of the source size. Not with width/height."
},
"dpi": {
"type": "integer",
"minimum": 1,
"maximum": 2400,
"description": "Pixels per inch of PNG output; needs a size in pt, mm, cm or in. Default 300."
},
"svg_version": {
"type": "string",
"enum": [
"1.1",
"1.0",
"tiny1.2"
],
"description": "SVG flavor: 1.1 (default), 1.0, or tiny1.2 (no opacity or gradient transforms)."
},
"svg_fixed_size": {
"type": "boolean",
"description": "true (default): width/height on the root <svg>; false: only a viewBox (responsive)."
},
"adobe_compat": {
"type": "boolean",
"description": "true: SVG friendly to Adobe Illustrator (size always set, stroke widths in drawing coordinates)."
},
"dxf_curves": {
"type": "string",
"enum": [
"lines",
"arcs",
"splines"
],
"description": "DXF curves as lines (polylines, default), arcs or splines. curves=lines/lines_arcs wins."
},
"png_antialias": {
"type": "string",
"enum": [
"on",
"off"
],
"description": "Anti-aliasing in PNG output. Default on."
},
"transparency": {
"type": "string",
"pattern": "^(keep|white|#[0-9a-fA-F]{6})$",
"description": "Transparent areas: keep (stay transparent), white, or a background color #rrggbb."
},
"width": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Physical output width in unit. With width only, the height follows the aspect ratio; with height too, a sheet of that size (see aspect). Up to 10 m."
},
"height": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Physical output height in unit (width follows the aspect ratio unless width is set too)."
},
"unit": {
"type": "string",
"enum": [
"px",
"pt",
"mm",
"cm",
"in"
],
"description": "Unit for width/height: px (default), pt, mm, cm, in."
},
"mode": {
"type": "string",
"enum": [
"live",
"test",
"preview"
],
"description": "test: free, watermarked result for building an integration. preview: free PNG up to 1 MP without watermark, no vectors; fetch its link with format=svg to buy the vectors for 1 credit. Neither is available for vectorize_url. Default live."
},
"retention_days": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Keep the result downloadable for this many days (default 24 hours). Live mode only."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"result_id": {
"type": "string"
},
"download_url": {
"type": "string",
"description": "Link to the first requested format."
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Download link per format."
},
"expires_at": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"svg_bytes": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"credits_remaining": {
"type": "integer"
},
"mode": {
"type": "string"
},
"free_remaining_today": {
"type": "integer",
"description": "Free MCP vectorizations left today (used before credits)."
}
},
"required": [
"files",
"width",
"height",
"credits_remaining"
]
}🟢open_editor
Use this when the user wants to vectorize an image but you cannot pass the image to vectorize (no image, upload_id or exact base64 bytes available), including when the user attached the image in Claude.ai: opens the Shapesoda window, where the user picks the file, sees the vector result and adjusts it. Does not vectorize by itself and uses no credits. Do not use for generating new images.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}⚪revectorize(result_id, token, image_type, quality, colors, ...)
Re-vectorizes a stored result (result_id and token from vectorize) with other settings, free for 24 hours after the first vectorization. Used by the Shapesoda window.
輸入結構描述
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"description": "result_id from vectorize or revectorize."
},
"token": {
"type": "string",
"description": "Result token (the token parameter of the result links)."
},
"image_type": {
"type": "string",
"enum": [
"auto",
"artwork",
"artwork_sharp",
"photo"
],
"description": "Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto."
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
],
"description": "Input quality: low for blurry/noisy/JPEG-heavy images. Default auto."
},
"colors": {
"description": "Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto.",
"anyOf": [
{
"type": "string",
"enum": [
"auto",
"unlimited"
]
},
{
"type": "integer",
"minimum": 2,
"maximum": 32
}
]
},
"palette": {
"description": "Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"minItems": 2,
"maxItems": 256
},
{
"type": "string"
}
]
},
"smoothness": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Contour smoothing 1–10 (higher: smoother, fewer nodes)."
},
"transparency": {
"type": "string",
"pattern": "^(keep|white|#[0-9a-fA-F]{6})$",
"description": "Transparent areas: keep (stay transparent), white, or a background color #rrggbb."
},
"corners": {
"type": "string",
"enum": [
"sharp",
"smooth"
],
"description": "Keep corners sharp or round them."
},
"min_area": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset."
}
},
"required": [
"result_id",
"token"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"result_id": {
"type": "string"
},
"download_url": {
"type": "string",
"description": "Link to the first requested format."
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Download link per format."
},
"expires_at": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"svg_bytes": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"credits_remaining": {
"type": "integer"
},
"mode": {
"type": "string"
},
"free_remaining_today": {
"type": "integer",
"description": "Free MCP vectorizations left today (used before credits)."
}
},
"required": [
"files",
"width",
"height",
"credits_remaining"
]
}🟢get_usage
Shows how many credits were used this month and how many remain.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本5 個工具