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.
