# io.github.shunyagatha/vecline (npm · vecline)

Local-first image, vector and document toolkit that measures its own output. Nothing uploaded.

- Trust score: 68/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-19

## Components

- npm · `vecline`: 68/100 (this document), [markdown](https://verifymcp.io/servers/shunyagatha-vecline/vecline.md), [page](https://verifymcp.io/servers/shunyagatha-vecline/vecline)

## Channel facts

- Registry: `npm`
- Package: `vecline`
- Version: `2.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-19.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 49 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 78/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1831 tokens (~114/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add shunyagatha-vecline -- npx -y vecline
```

### Codex

```bash
codex mcp add shunyagatha-vecline -- npx -y vecline
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shunyagatha-vecline": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "vecline"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add shunyagatha-vecline --command npx --arg -y --arg vecline
```

### Hermes

```yaml
mcp_servers:
  shunyagatha-vecline:
    command: "npx"
    args: ["-y", "vecline"]
```

### Other

```json
{
  "mcpServers": {
    "shunyagatha-vecline": {
      "command": "npx",
      "args": [
        "-y",
        "vecline"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-19 (score 68, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-08-18 (score 52, −15)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 1368 → 1831
- [functional] Package version: 2.0.0 → 2.1.1
- [functional] Package version: 2.0.0 → 2.1.0

### 2026-08-17 (score 67, +12)

- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → 1.00

### 2026-08-16 (score 55, +6)

- [security regression] GHSA-f88m-g3jw-g9cj affects this package: high
- [security regression] Known CVEs: unverified → fail
- [security improvement] Known CVEs: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: pass → fail
- [functional improvement] Tool coverage: 19% → 100%
- [functional improvement] Stability: unverified → 0.03
- [functional improvement] Dependency health: unverified → 1.00
- [functional] First check of Schema quality: unverified
- [functional] Schema quality: good → excellent
- [functional] Package version: 1.44.1 → 2.0.0
- [functional] Package version: 1.44.1 → 1.48.0
- [functional] Package version: 1.44.1 → 1.47.0
- [functional] Package version: 1.44.1 → 1.46.0
- [functional] Package version: 1.44.1 → 1.45.0

### 2026-08-15 (score 49)

First indexed and scored.

## MCP tools (16)

### `vectorize` (~309 tokens)

Convert a raster image (PNG/JPEG/WebP/…) to SVG, locally and deterministically. BEST FOR flat art — logos, icons, UI, screenshots, pixel art — where `lossless` mode returns vector geometry that rasterises back BIT-EXACT (verified, not asserted). For photographs it produces a measured approximation; a neural cloud vectoriser will often look better, so prefer this when determinism, privacy or provable exactness matter. Auto-picks pixel/trace/embed, or force a mode. Writes to `output` if given, else returns the SVG. Pass `verify: true` to render the SVG back and return SSIM/PSNR/ΔE and whether it is pixel-identical — the proof, in the same call.

Input parameters:

- `colors` (number): Palette size for trace mode (2–256)
- `input` (string, required): Path to the source raster image
- `mode` (string): auto (default) picks per image; pixel/lossless are bit-exact on flat art; trace approximates with paths; embed wraps the original raster losslessly
- `output` (string): Optional .svg output path
- `preset` (string): Tuning for the trace path; ignored by pixel and embed modes
- `verify` (boolean): Rasterise the result back and measure it. Returns JSON with ssim, psnr, meanDeltaE, pixelIdentical and svgBytes instead of the SVG text. Costs one extra render.

### `convert` (~91 tokens)

Convert between formats by extension. Supports raster↔SVG plus vector export to .dxf/.eps/.pdf (CAD/CNC/print).

Input parameters:

- `cmyk` (boolean): Emit CMYK colour in EPS/PDF output, for print workflows
- `input` (string, required): Path to the source file (raster or SVG)
- `output` (string, required): Destination path; its extension chooses the target format

### `centerline` (~109 tokens)

Trace line art to single-stroke centreline SVG (for plotters, lasers, CNC). Optionally emit G-code with tool=laser|pen.

Input parameters:

- `gcode` (boolean): Emit G-code toolpaths instead of an SVG. Changes the output format.
- `input` (string, required): Path to the line-art image
- `output` (string): Optional output path; extension should match the format produced
- `tool` (string): G-code dialect; only used when gcode is true

### `measure` (~76 tokens)

Measure how close two images (raster or SVG) are: PSNR, SSIM, mean CIEDE2000, and whether they are pixel-identical.

Input parameters:

- `candidate` (string, required): Path to the image being scored against the reference
- `reference` (string, required): Path to the original / expected image (raster or SVG)

### `diff` (~138 tokens)

Perceptual visual-regression diff. Paints a CIEDE2000 heatmap of what changed between two images (raster or SVG) and reports changed-pixel count/fraction, max & mean ΔE, and SSIM. Give an output path to save the heatmap.

Input parameters:

- `candidate` (string, required): Path to the image being compared; must match the reference size
- `output` (string): Optional .png heatmap path
- `reference` (string, required): Path to the baseline image (raster or SVG)
- `threshold` (number): CIEDE2000 above which a pixel counts as changed (default 2)

### `crop` (~145 tokens)

Content-aware crop to an aspect ratio, keeping the salient subject (edges + saturation) rather than the centre. aspect like "1:1", "16:9", "4:5".

Input parameters:

- `aspect` (string): Target ratio as "W:H", e.g. "1:1", "16:9", "4:5". Default "1:1"
- `height` (number): Explicit target height in pixels; an alternative to aspect
- `input` (string, required): Path to the image to crop
- `output` (string, required): Destination path; its extension chooses the encoder
- `width` (number): Explicit target width in pixels; an alternative to aspect

### `palette` (~54 tokens)

Extract a perceptual dominant-colour palette (hex + weight) from an image.

Input parameters:

- `colors` (number): How many dominant colours to return (default 6)
- `input` (string, required): Path to the image to sample

### `placeholder` (~34 tokens)

Generate a BlurHash string for lazy-loading a raster image.

Input parameters:

- `input` (string, required): Path to the raster image to summarise

### `image_info` (~74 tokens)

Inspect an image without converting it: dimensions, format, colour space, alpha, distinct colour count and run density — and which vectorize mode suits it, including whether bit-exact output is achievable. Call this first when choosing between `pixel` and `trace`.

Input parameters:

- `input` (string, required): Path to the image to inspect

### `doc_to_images` (~178 tokens)

Render a document (PDF, SVG, or Office docx/xlsx/pptx) to one image per page. PDF needs the optional mupdf package; Office needs local LibreOffice. [LIMITED on this machine: SVG input works; PDF needs the optional `mupdf` package (npm i mupdf) and Office needs LibreOffice.]

Input parameters:

- `dpi` (number): Render resolution; higher is sharper and slower (default 144)
- `format` (string): png (default), jpeg, webp, avif
- `input` (string, required): Path to the PDF, SVG or Office document
- `outDir` (string, required): Directory to write page images into; created if absent
- `pages` (string): 1-based page spec, e.g. "1,3-5" (PDF/Office)

### `office_convert` (~89 tokens)

Convert an Office document ⇄ PDF (and between Office formats) via local LibreOffice. Target format is the output file extension. [UNAVAILABLE on this machine: needs LibreOffice (install from libreoffice.org, or set VECLINE_SOFFICE).]

Input parameters:

- `input` (string, required): Path to the source document
- `output` (string, required): Destination path; its extension chooses the target format

### `rasterize` (~135 tokens)

Render an SVG to a raster image (PNG/JPEG/WebP/AVIF/TIFF). The inverse of vectorize, and the way to see what an SVG actually draws — an agent that has produced or received SVG can turn it into pixels it is able to inspect.

Input parameters:

- `background` (string): Paint onto this colour, e.g. "#ffffff". SVGs render on transparent by default.
- `input` (string, required): Path to the SVG
- `output` (string): Destination path; its extension chooses the encoder (default .png)
- `width` (number): Render width in pixels; height follows the aspect ratio

### `extract` (~105 tokens)

Recover the original bitmap from an SVG written by embed/lossless mode, and verify it byte for byte. This is the proof behind the round-trip claim: the recovered file is hashed and checked against the digest recorded when the SVG was written, so an agent can demonstrate exactness rather than assert it.

Input parameters:

- `input` (string, required): Path to an SVG carrying an embedded bitmap
- `output` (string): Where to write the recovered file; defaults beside the input with its own extension

### `optimize` (~91 tokens)

Minify an SVG without changing what it draws: round coordinates, drop default attributes, strip the prolog. Render-preserving by construction, so it is safe on any SVG, not only ours.

Input parameters:

- `input` (string, required): Path to the SVG
- `output` (string): Destination path; overwrites the input when omitted
- `precision` (number): Decimal places kept in path coordinates (0–8)

### `component` (~132 tokens)

Turn an SVG into a React, Vue, Svelte or Solid component, ready to import. Emits typed TSX for React and Solid and an SFC for Vue and Svelte, and refuses rather than writing source that will not parse.

Input parameters:

- `currentColor` (boolean): Replace solid fills with currentColor so CSS `color` drives it
- `framework` (string): Target framework (default react)
- `input` (string, required): Path to the SVG
- `name` (string): Component name, PascalCase (default Icon)
- `output` (string): Destination path; defaults beside the input with the framework extension

### `images_to_pdf` (~71 tokens)

Combine images into one multi-page PDF (one image per page).

Input parameters:

- `dpi` (number): Assumed image resolution, which sets the physical page size (default 72)
- `inputs` (array, required): Image paths, in the page order you want
- `output` (string, required): Destination .pdf path

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/shunyagatha-vecline/vecline#diagnostics

## Score history

- 2026-08-19: 68
- 2026-08-18: 52
- 2026-08-17: 67
- 2026-08-16: 55
- 2026-08-15: 49

## Links

- npm package: https://www.npmjs.com/package/vecline
- Socket report: https://socket.dev/npm/package/vecline
- Repository: https://github.com/shunyagatha/Vecline
- Website: https://vecline.xyz/
- Changelog RSS feed: https://verifymcp.io/servers/shunyagatha-vecline/vecline.xml
- Changelog JSON feed: https://verifymcp.io/servers/shunyagatha-vecline/vecline.json
- HTML version of this page: https://verifymcp.io/servers/shunyagatha-vecline/vecline