mermaid-live-mcp - From prompt to diagram in seconds

Created By
iishyfishyy4 months ago
An MCP server that generates live Mermaid diagrams from any AI assistant. Claude, Cursor, and more. https://iishyfishyy.github.io/mermaid-live-mcp/
Overview

mermaid-live-mcp

MCP server for generating Mermaid diagrams with live browser preview. Renders diagrams in real-time and supports SVG/PNG export.

npm version

mermaid-live-mcp demo

Install

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mermaid": {
      "command": "npx",
      "args": ["-y", "mermaid-live-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "mermaid": {
      "command": "npx",
      "args": ["-y", "mermaid-live-mcp"]
    }
  }
}

Claude Code

claude mcp add mermaid -- npx -y mermaid-live-mcp

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mermaid": {
      "command": "npx",
      "args": ["-y", "mermaid-live-mcp"]
    }
  }
}

Tools

ToolDescription
generate_mermaidGenerate a diagram from Mermaid syntax and open a live preview in the browser
update_diagramReplace a diagram's Mermaid syntax and re-render the live preview
list_diagramsList all diagrams generated in the current session
export_diagramWrite a diagram's SVG to disk

How it works

When you ask your AI assistant to create a diagram, mermaid-live-mcp will:

  1. Parse the Mermaid syntax
  2. Open a browser tab with a live preview
  3. Render the diagram as SVG in real-time via WebSocket
  4. Provide download buttons for SVG and PNG export

Updates to a diagram are pushed instantly to the browser — no page refresh needed.

Supported diagram types

All Mermaid diagram types are supported, including flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, mindmaps, timelines, and more.

Development

pnpm install
pnpm build

Project structure

PackageDescription
packages/mcp-serverMCP server (published as mermaid-live-mcp)
packages/previewLive browser preview via WebSocket
packages/coreDiagram parsing, layout, and SVG rendering
packages/cliCommand-line interface

License

MIT

Project Info
Created At
4 months ago
Updated At
4 months ago
Author Name
iishyfishyy
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Alloy

a day ago
Crevio

17 hours ago