Mermaid MCP Server
Mermaid diagram generation and export capabilities for AI assistants.
Data last scanned yesterday · Reviewed 3 weeks ago
Overview
Mermaid MCP Server provides AI models with the ability to generate, style, and export complex diagrams and charts directly from text prompts. It supports the full range of Mermaid syntax, allowing users to create flowcharts, sequence diagrams, and more with customizable themes and background colors. Beyond simple generation, the server facilitates multi-round interactions where models can validate and refine Mermaid syntax. Output options are flexible, supporting formats like SVG, base64, and files, or providing public URLs for sharing via mermaid.ink.
Our verdict
This server carries a high risk level with a security score of 48/100. Because it is community-maintained rather than official, and lacks an editorially reviewed authentication or read-only mode, users should exercise caution. It is suitable for experimental environments or non-sensitive personal workflows, but not recommended for systems requiring robust security guarantees.
- Supports all Mermaid syntax and rich visual configurations
- Generates PNG files directly to disk or public URLs
- Low supply-chain footprint with only seven direct dependencies
- Active community engagement with 625 stars and 12 contributors
- Lacks an official vendor audit or editorial security review
- Authentication mechanisms remain unreviewed for potential vulnerabilities
Setup
{
"mcpServers": {
"mcp-mermaid": {
"args": [
"-y",
"mcp-mermaid"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What output formats does this server support?
The server supports output in base64, svg, mermaid, file, and remote-friendly svg_url or png_url formats.
›How can I save generated diagrams directly to my computer?
You can use the outputType: 'file' configuration to automatically save PNG diagrams to your local disk.
›Does the server support style customization for diagrams?
Yes, you can configure backgroundColor and theme settings to enable AI models to output rich style configurations.
›What transport protocols are supported?
The server supports stdio, SSE (Server-Sent Events), and streamable transport protocols.
›Can I run this server using Docker?
Yes, you can pull the image 'susuperli/mcp-mermaid:latest' and run it using either SSE or streamable transport modes.
Alternatives
Changelog
Badge
Maintain this server? Add the live badge to your README.