Skip to main content
Glama
showcase-mcp
by him0

showcase-mcp

An MCP server that displays rich content (Markdown, HTML, Mermaid diagrams, images) in a native desktop window.

When an MCP client like Claude Code calls the show tool, a Neutralino.js-based window opens and renders content in real time via SSE.

Demo

Features

  • Markdown — Rendered via marked

  • HTML — Raw HTML display

  • Mermaid — SVG diagram rendering

  • Images — Display by URL

  • Window ID management — Update existing windows by ID, or open new ones

  • Real-time updates via SSE — Content is pushed to the window without reopening

  • Non-blocking — Tool calls return immediately

Related MCP server: mermaid-live-mcp

Requirements

  • Node.js >= 20

  • pnpm

Setup

pnpm install

# Download Neutralino binary
pnpm run setup

# Build React bundle + Tailwind CSS
pnpm run build:assets

# Compile TypeScript
pnpm run build:ts

Usage

With Claude Code

Add the following to your .mcp.json:

{
  "mcpServers": {
    "showcase-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["tsx", "<path-to>/showcase-mcp/src/index.ts"]
    }
  }
}

Then call the show tool from Claude Code to open a window.

Development

pnpm dev

show Tool

Parameters

Parameter

Type

Description

title

string

Title displayed at the top of the window (required)

message

string?

Markdown-formatted text

html

string?

Raw HTML content

mermaid

string?

Mermaid diagram source code

imageUrl

string?

URL of an image to display

windowId

string?

Window ID to update. Omit to open a new window.

Response

{ "windowId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }

Behavior

windowId

Action

Omitted

Opens a new window. Returns a new windowId.

Valid (window is open)

Updates the existing window's content. Returns the same windowId.

Invalid (window closed / unknown)

Opens a new window. Returns a new windowId.

Architecture

MCP Client (stdio) → MCP Server → Hono HTTP Server (port=0) → Neutralino Window
                                         ↕ SSE
                                    React UI (App.tsx)
  1. MCP client calls show

  2. Hono HTTP server starts on a random port and a Neutralino window opens

  3. React UI connects via SSE (/events) and renders content

  4. Subsequent calls with the same windowId update content through SSE

  5. Calls without windowId always open a new window

  6. Closing a window cleans up its HTTP server

Available Tools

1 tool
showA

Display rich content (Markdown, HTML, Mermaid diagrams, images) in a window. Pass windowId to update an existing window's content. Omit windowId to open a new window. Returns the windowId for future updates.

Inputs: title (required), html, mermaid, message, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly described and distinct.

    Naming Consistency5/5

    The single tool name 'show' is a clear, consistent verb that accurately reflects its action. There are no other names to create inconsistency.

    Tool Count3/5

    The server has only one tool, which feels thin for a general-purpose display server. However, the tool is feature-rich for its narrow scope, so it is not an extreme mismatch.

    Completeness4/5

    The tool covers opening and updating windows, which are the core display operations. A minor gap is the lack of an explicit close or hide operation, but this can be worked around.

    Related MCP Connectors

    Related MCP Servers