Optiq Mcp

io.github.BaukaalmPublished by GitHub account Baukaalmv0.1.0-beta.3Updated Oct 29, 2026

Optimise project images locally with verified quality (SSIM or pixel-exact): JPEG, PNG, WebP, AVIF.

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

Local MCP server that lets an assistant analyze and optimize a project's JPEG, PNG, WebP and AVIF images with verified quality.

What you can do
  • Analyze images as a dry run, reporting chosen format, bytes before and after, and measured quality (SSIM or pixel-exact)
  • Optimize images in place, keeping formats and file names so code references stay valid
  • Optimize images into an output directory, where formats may change
  • Apply quality modes (lossless, visually-lossless, balanced, fast) and options such as format keeping, target formats, max size downscaling, metadata stripping and minimum saving
When to use it
Useful when a project's image assets need shrinking and you want the assistant to check quality before and after, with no uploads. Suited to web or app repositories where image references must keep working.
Requirements
Runs locally over stdio via npx (npm package optiq-mcp); requires Node 20 or newer. No accounts, API keys or environment variables are declared.
Before you install
optimize_images writes files: in-place mode replaces originals, though only when the result passes the quality check and is smaller. Lossy outputs get a marker so repeat runs do not compound loss unless reoptimize is enabled. stripMetadata removes EXIF including GPS and XMP, which may be wanted data.

Installation

In SourceWeft

  1. Open Optiq Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

optiq-mcp

An MCP server that lets AI agents optimise the images in a project with Optiq. It runs locally over stdio, and nothing is uploaded.

sh
claude mcp add optiq -- npx -y optiq-mcp          # Claude Code
json
{ "mcpServers": { "optiq": { "command": "npx", "args": ["-y", "optiq-mcp"] } } }

The JSON form is for Claude Desktop, Cursor and other clients. For VS Code (.vscode/mcp.json), use { "servers": { "optiq": { "type": "stdio", "command": "npx", "args": ["-y", "optiq-mcp"] } } }.

Tools

ToolWritesWhat it does
analyze_imagesno (readOnlyHint)Dry run. For each image it reports the chosen format, the bytes before and after, and the measured quality (SSIM, or pixel-exact)
optimize_imagesyeswrite: "in-place" keeps formats and names, so references in code stay valid. write: "out-dir" may change formats

What each mode guarantees:

  • lossless: pixels are verified identical;
  • visually-lossless: SSIM ≥ 0.99;
  • balanced (the default): SSIM ≥ 0.975;
  • fast: the same threshold as balanced, but no AVIF and fewer encodes.

A file is replaced only when the result passes the check and is smaller. Lossy outputs carry a ~20-byte marker, so running optimize_images again does not re-encode them and cannot compound the loss (reoptimize: true overrides this).

Other options:

  • mode;
  • keepFormat;
  • formats;
  • maxSize (downscale the longest side);
  • stripMetadata (removes EXIF including GPS, and XMP);
  • minQuality;
  • minSaving.

Full docs: https://baukaalm.github.io/optiq/guide/agents

Requires Node ≥ 20. Apache-2.0. The codec licences are listed in the optiq-image NOTICE.

Source: mcp/README.md at commit bb28477

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0-beta.3LatestOct 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts