Mermaid MCP Server

@peng-shawn

Basic information

About Mermaid MCP Server

A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images

Mermaid MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mermaid-mcp-server": {
      "command": "npx",
      "args": [
        "tsc"
      ]
    }
  }
}

Mermaid MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Mermaid MCP Server?

Mermaid MCP Server converts Mermaid diagram code into PNG images or SVG files. It uses Puppeteer for headless browser rendering and implements the Model Context Protocol (MCP) so AI assistants and other applications can generate visual diagrams from textual descriptions.

How to use Mermaid MCP Server?

Run the server with npx -y @peng-shawn/mermaid-mcp-server. Configure it as an MCP tool in Claude Desktop, Cursor, or Cline using the provided JSON entries. The server exposes a single generate tool that accepts parameters code, theme, backgroundColor, outputFormat, name, and folder. Set the environment variable CONTENT_IMAGE_SUPPORTED to true (default) for inline images or false to save to disk.

Key features of Mermaid MCP Server

Converts Mermaid code to PNG or SVG
Supports four diagram themes: default, forest, dark, neutral
Customizable background colors
Uses Puppeteer for high‑quality rendering
Implements MCP protocol for seamless AI integration
Returns images inline or saves them to disk

Use cases of Mermaid MCP Server

Generate flowcharts, sequence diagrams, and class diagrams in AI assistants
Create diagrams with specific themes and background colors
Save diagram files to disk when inline images are not supported (e.g., Cursor)
Automate diagram generation in MCP‑compatible tools

Frequently asked questions

Does Claude desktop already support Mermaid via canvas?

Yes, but it does not support the `theme` and `backgroundColor` options. A dedicated server makes it easier to create Mermaid diagrams with different MCP clients.

Why do I need to set `CONTENT_IMAGE_SUPPORTED=false` when using with Cursor?

Cursor does not support inline images in responses yet. Setting the variable to `false` saves the diagram to disk and returns the file path.

What are the runtime dependencies?

The server requires Node.js (to run the npx command) and relies on Puppeteer’s bundled Chromium or a system‑installed Chrome/Chromium for headless rendering.

How are generated images returned or stored?

When `CONTENT_IMAGE_SUPPORTED=true` (default), the image or SVG is returned inline in the MCP response. When `false`, the file is saved to the specified folder and the file path is returned.

Which transport does the server use?

The server communicates over stdio using the MCP protocol. It can be tested and debugged with the MCP Inspector (`npx @modelcontextprotocol/inspector`).

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w