VectorMagic MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VectorMagic MCP Server vectorize D:\logos\client-logo.png as an SVG with low detail"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Why
Vector Magic Desktop Edition is one of the best automatic tracers, but it has no command line and no API — only a wizard GUI. This Model Context Protocol server drives that GUI for you, so you can ask Claude things like:
"Vectorize
D:\logos\client.pngas an EPS with low detail." "Convert every image inD:\scansto SVG with unlimited colours and put them inD:\scans\vector."
It was inspired by ie3jp/illustrator-mcp-server; the result opens directly in Illustrator, Inkscape, CorelDRAW, AutoCAD, etc.
Related MCP server: vectorplease-mcp
Features
Input | png, jpg, jpeg, bmp, tif, tiff, gif, psd, jp2, pcx, ppm, pnm, pgm, pbm, tga, jng, mng, xpm |
Vector output | svg, ai, eps, pdf, dxf, emf |
Bitmap output | png, jpg, bmp, tif — re-rendered from the vector result at 1×, 2× or 4× |
Options | level of detail, colour mode, shape layering, strokes, DXF curve mode |
Batch | a list of files or a whole folder in one call |
Feedback | a preview image of the vector result + what Vector Magic detected (image type, detail, colours) |
Safe | never overwrites files, never touches Vector Magic windows you have open, restores your Vector Magic settings after every run, works offline |
Requirements
Windows 10/11
Vector Magic Desktop Edition (tested with 1.15), licensed and activated
Node.js ≥ 20 (bundled with Claude Desktop for
.mcpbinstalls)
Installation
Claude Desktop (recommended)
Download
vectormagic-mcp-server.mcpbfrom the latest release.Double-click it (or drag it onto Claude Desktop → Settings → Extensions) and click Install.
Optional: if Vector Magic is not in
C:\Program Files (x86)\Vector Magic, set the path tovmde.exein the extension settings.
Claude Code / other MCP clients
git clone https://github.com/jhonsu01/VectorMagic-mcp-server.git
cd VectorMagic-mcp-server
npm install
npm run build
claude mcp add vectormagic -- node "%CD%\dist\bundle.cjs"Generic MCP config:
{
"mcpServers": {
"vectormagic": {
"command": "node",
"args": ["C:\\path\\to\\VectorMagic-mcp-server\\dist\\bundle.cjs"],
"env": { "VECTOR_MAGIC_EXE": "C:\\Program Files (x86)\\Vector Magic\\vmde.exe" }
}
}
}Tools
vectorize_image
Parameter | Default | Description |
| — | Absolute path of the image |
| next to the input | Absolute output path; the extension must match |
|
|
|
|
|
|
|
|
|
|
|
|
|
| Outline each shape with a stroke of its colour |
|
|
|
|
|
|
|
| Replace an existing output file |
|
| Return a PNG preview of the result |
|
| Keep the Vector Magic window on screen (debugging) |
Returns the output path, size, elapsed time, a vector_magic_summary such as 400x400 (0.2 megapixel) Basic: Smooth artwork, Medium, 6 colors, and the preview.
vectorize_batch
Same options, plus input_paths (list) or input_dir (non-recursive), and output_dir. One result per image; a failure does not stop the batch.
get_vector_magic_status
Installation path, version, open Vector Magic windows, supported formats and timeouts.
How it works
Claude ──MCP──▶ Node server ──▶ PowerShell engine ──▶ Vector Magic (its own window, off-screen)
│ posted mouse messages (your cursor is never moved)
│ UI Automation (widget names) to know which wizard page is open
│ Windows OCR of the status bar to confirm the settings
└ registry: export options in, your settings restored afterwardsCopies the image to a temporary folder and backs up Vector Magic's settings (
HKCU\Software\Vector Magic).Writes the export options, starts a new
vmde.exeand moves its window off-screen.Runs Fully Automatic, applies the requested detail / colours on the review page, and uses Quick Save (no file dialogs).
Copies the result to the destination, closes its Vector Magic window and restores your settings.
Runs are queued one at a time (Vector Magic keeps a single settings key). A typical logo takes 10–20 s.
Configuration
Variable | Default | |
|
| Path to |
|
| Seconds to open the image |
|
| Seconds per vectorization pass |
|
| Seconds to write the file |
Troubleshooting
"Vector Magic (vmde.exe) not found" — set
VECTOR_MAGIC_EXE(or the extension setting)."Unexpected dialog" — Vector Magic showed a message (activation, very large image…). The error includes a
debug_snapshotPNG in%TEMP%\vectormagic-mcp-debug. Open Vector Magic once by hand to clear it.Timeouts with huge photos — raise
VECTOR_MAGIC_VECTORIZE_TIMEOUT.The
vector_magic_summaryis read by OCR and may miss a letter (e.g.Medo); it is informative only.
Limitations
Windows only; tested with Vector Magic Desktop Edition 1.15 with the Spanish UI. Page detection uses widget names and is language-independent; the OCR check of the detail level knows Spanish, English, German, French and Italian words.
Uses the Fully Automatic pipeline; the Basic/Advanced wizards and manual segmentation editing are not automated (yet).
One conversion at a time.
Privacy
Everything runs locally. The server makes no network requests and sends no telemetry. Images are copied to a temporary folder that is deleted after each run.
Development
npm install
npm run build # tsc + copy PowerShell engine + esbuild bundle
npm test # unit tests (no Vector Magic needed)
npm run test:e2e # real MCP end-to-end test (needs Vector Magic)
npm run pack:mcpb # builds vectormagic-mcp-server.mcpbThe PowerShell engine (src/ps/) must stay pure ASCII: Windows PowerShell 5.1 reads BOM-less scripts in the ANSI code page (a unit test enforces it).
License
MIT. Vector Magic is a trademark of Vector Magic, Inc. This project is not affiliated with or endorsed by Vector Magic, Inc. — you need your own licensed copy of Vector Magic Desktop Edition.
Available Tools
3 toolsget_vector_magic_statusVector Magic statusARead-onlyIdempotent
Check that Vector Magic Desktop Edition is installed and usable: executable path, version, Vector Magic windows already open (the connector never touches them; it starts its own), supported input/output formats and timeouts.
Inputs: no named parameters.
vectorize_batchVectorize several imagesA
Vectorize many images in one call with the same options (one Vector Magic run per image, sequentially). Give either input_paths or input_dir (non-recursive; only supported image types are picked). Outputs go to output_dir, or next to each input. Returns one result per image; a failure does not stop the batch.
Inputs: colors, detail, format, dxf_mode, +8 more.
vectorize_imageVectorize imageA
Convert a bitmap image (PNG, JPG, GIF, BMP, TIFF, PSD, TGA...) into an editable vector file with Vector Magic Desktop Edition. Uses Vector Magic's fully automatic mode, then optionally changes the level of detail and colour mode, and writes SVG, AI, EPS, PDF, DXF or EMF (or a re-rendered PNG/JPG/BMP/TIF). Returns the output path, a summary of what Vector Magic detected (image type, detail, number of colours) and a preview image of the vector result. Takes ~10-30 s per image; large photos take longer. Files are never overwritten unless overwrite is true.
Inputs: input_path (required), colors, detail, format, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools target clearly distinct operations: single-image conversion, batch conversion, and environment/health status. There is no overlap or plausible misselection between vectorize_image and vectorize_batch since the scope difference (one vs many) is explicit.
All names use snake_case with a verb_noun pattern (vectorize_image, vectorize_batch, get_vector_magic_status). The verbs differ meaningfully but the convention is uniform and predictable.
Three tools is a tight, well-scoped surface for an image-to-vector conversion service: one for a single file, one for batches, one for environment checks. It is slightly lean but each tool clearly earns its place.
The core lifecycle of vectorizing images (single, batch) plus a status/preflight check is covered, and format support is reported via status. Minor gaps like querying or re-rendering prior results without re-running are acceptable workarounds.
Maintenance
Related MCP Connectors
Convert PNG, JPG and WebP images, including AI-generated ones, to clean SVG, PDF, EPS or DXF.
Convert images to clean SVG with few anchor points, plus centerline single lines.
Convert PNG, JPG and WebP images to SVG vector paths. Runs on Apify, $0.01 per image.
Hosted MCP front door to the Vectorize API: raster-to-vector tracing to SVG, PDF, EPS or DXF.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to automate Adobe Illustrator, converting bitmap artwork into editable .ai files, running ExtendScript, and capturing the Illustrator window for visual QA.1-

vectorplease-mcpofficial
AlicenseAqualityCmaintenanceConverts PNG, JPEG, or WebP bitmaps into sticker-ready SVGs from any MCP client, taking local paths, HTTPS URLs, or base64 input, optionally applying a preset and writing the result to a file while returning quality metrics. It also lists available artwork presets and retrieves the result of a conversion that was still running.3MIT
Pic2Vector MCPofficial
AlicenseAqualityCmaintenanceEnables AI assistants such as Claude Desktop, Cursor, and VS Code to convert local or remote PNG and JPG images into SVG vectors through a single vectorize_image tool, using offline vtracer tracing in color or black-and-white modes.167 npmMIT- FlicenseNot gradedqualityBmaintenanceEnables AI clients such as Claude Desktop, Claude Code, Cursor, and VS Code to drive a local CorelDRAW instance through natural language via its COM API, covering batch image search and PowerClip placement, batch data/sign board production, org-chart generation, shape and bitmap import, and export. All edits run through session and version-checked atomic operations that roll back on error and can be undone in one step.1-