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 modelsopen_editor 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~3,338トークン数（ツール定義）
~6.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.61%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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 件