Skip to main content
Glama

mcp-image-previewer

An MCP (Model Context Protocol) server that previews base64-encoded images in a native GUI window using Slint.

Features

  • Native GUI — Slint-based window, no Python or external runtime needed

  • Window reuse — Same window updates in-place across multiple images

  • Always-on-top — Optionally pin the preview window above other windows

  • Show/hide — Toggle window visibility without losing state

  • Format support — PNG, JPEG, WebP, GIF, TIFF, etc. (via sharp)

Related MCP server: image-to-base64

Requirements

  • Node.js 18+

Installation

Claude Code

claude mcp add image-previewer -- npx mcp-image-previewer

Manual configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "image-previewer": {
      "command": "npx",
      "args": ["mcp-image-previewer"]
    }
  }
}

Tools

preview_image

Display a base64-encoded image in the viewer window.

Parameter

Type

Required

Description

data

string

Yes

Base64-encoded image data

mimeType

string

Yes

MIME type (e.g. image/png, image/jpeg)

show_window

Show or hide the preview window.

Parameter

Type

Required

Description

visible

boolean

Yes

true to show, false to hide

stay_on_top

Set whether the preview window stays on top of other windows (X11/Windows only).

Parameter

Type

Required

Description

enabled

boolean

Yes

true to enable, false to disable

Development

npm install
npm run build
npm start

License

MIT

Related MCP Connectors

Related MCP Servers