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 个工具