MCP.so
Sign In

Mermaid MCP Server

@MCP-Mirror

About Mermaid MCP Server

Mirror of

Basic information

Category

Other

License

MIT license

Runtime

node

Transports

stdio

Publisher

MCP-Mirror

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mermaid MCP Server?

A Model Context Protocol (MCP) server that converts Mermaid diagram markdown code into PNG images using Puppeteer for headless browser rendering. It is designed for AI assistants and developers who need to generate visual diagrams from textual descriptions.

How to use Mermaid MCP Server?

Install via npx and configure as an MCP server in your client (e.g., Claude Desktop, Cursor). The tool generate accepts Mermaid code, optional theme and background color, and if CONTENT_IMAGE_SUPPORTED=false requires name and folder parameters to save the image to disk.

Key features of Mermaid MCP Server

  • Converts Mermaid diagram code to PNG images.
  • Supports diagram themes: default, forest, dark, neutral.
  • Customizable background colors.
  • Uses Puppeteer for high-quality headless browser rendering.
  • Returns images directly or saves them to disk.
  • Detailed error handling with descriptive messages.

Use cases of Mermaid MCP Server

  • Generate flowcharts, sequence diagrams, and class diagrams from text.
  • Create diagrams with specific themes and background colors.
  • Save diagrams to disk for use in documentation or projects.
  • Integrate with Claude Desktop, Cursor, or other MCP-compatible clients.

FAQ from Mermaid MCP Server

Doesn't Claude desktop already support mermaid via canvas?

Yes, but it doesn't support the theme and backgroundColor options. A dedicated server also makes it easier to create diagrams with other MCP clients.

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

Cursor does not support inline images in responses, so the server saves the image to disk instead of returning it directly.

Comments

More Other MCP servers