# vecline

vecline — a local-first toolkit that converts between ten raster formats, traces images to SVG, and renders PDFs and Office files. Every conversion reports its own accuracy and nothing leaves your machine.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 repo stars
- Author: shunyagatha
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shunyagatha/Vecline
- Updated: 2026-08-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/vecline

## What it does

Vecline converts ten raster formats in both directions and traces artwork to SVG. The difference from most vectorizers is the measurement step: after each run you get SSIM, PSNR and RMSE numbers, and `--lossless` either returns a bit-exact SVG or exits with an error. No silent near-misses.

Flat artwork — logos, icons, screenshots, pixel art — gets exact geometry. Photographs end up as embedded bitmaps, because a compact set of Bézier curves cannot hold all the information in a photo. Vecline tells you the ratio it measured instead of pretending otherwise.

The core is zero-dependency and CI-proven to bundle for a browser. Rendering Office files requires LibreOffice; set the `VECLINE_SOFFICE` environment variable to its path, or docx/xlsx/pptx conversion will not work.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VECLINE_SOFFICE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VECLINE_SOFFICE=<VECLINE_SOFFICE> --transport stdio vecline -- npx -y vecline
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add vecline --env VECLINE_SOFFICE=<VECLINE_SOFFICE> -- npx -y vecline
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vecline": {
            "command": "npx",
            "args": [
                "-y",
                "vecline"
            ],
            "env": {
                "VECLINE_SOFFICE": "<VECLINE_SOFFICE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vecline": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vecline"
            ],
            "env": {
                "VECLINE_SOFFICE": "<VECLINE_SOFFICE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VECLINE_SOFFICE=<VECLINE_SOFFICE> vecline npx -y vecline
```
Replace <…> with your own values

## When to use it
- trace a logo to SVG and see the real SSIM value
- render a docx or PDF to an image
- export DXF at a true physical cut size
- verify the SVG lost no pixels after conversion
- build a favicon or sprite sheet from one source

## Example prompts
- Vectorize `logo.png` with verification and show me the SSIM
- Convert `report.docx` to PDF through Vecline
- Trace `sketch.png` to SVG with real curves, no subpixel offset

## Similar
- [CoreNexis API](https://affpapa.org/en/nevibecode/mcp/corenexis-api.md) — MCP server
- [pixel2motion](https://affpapa.org/en/nevibecode/skills/pixel2motion.md) — skill · 608 installs
- [svg-tracer](https://affpapa.org/en/nevibecode/mcp/svg-tracer.md) — MCP server · ★ 81 repo stars
- [Image to SVG](https://affpapa.org/en/nevibecode/mcp/image-to-svg.md) — MCP server · ★ 11 repo stars
- [drawio](https://affpapa.org/en/nevibecode/skills/drawio.md) — skill · 314 installs
- [OpenCalque](https://affpapa.org/en/nevibecode/mcp/opencalque.md) — MCP server · ★ 128 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
