MCP Mermaid
An MCP server that generates mermaid diagrams and charts with syntax validation and svg, png and file export
- 649 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Can write png files to disk
- Link modes send the diagram to the external mermaid.ink service
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-mermaidDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Can write png files to disk
- Link modes send the diagram to the external mermaid.ink service
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent mermaid diagram generation: flowcharts, sequence diagrams, entity relations and other types. You can set the background and theme so the model returns styled diagrams. Output comes as base64, svg, raw mermaid, a file on disk or a link to svg and png. Built-in validation lets the model fix a syntax error over a few rounds and get a correct diagram. It supports stdio, sse and streamable-http transports and ships a Docker image.
Who it is for. For developers, technical writers and product managers who need diagrams straight from an agent.
Good fit when
- You need a flowchart or sequence diagram from a description
- You need a diagram as svg, png or a file
- You need mermaid syntax validation before pasting into a doc
Not a fit when
- You need diagram formats mermaid does not support
- You cannot send data outward but need the mermaid.ink link mode
Example request
Build a flowchart of the signup process and return it as an svg file with a light themeMCP
- Transport
- stdio, sse, http
- Authentication
- not required
Limitations
Diagrams are limited to mermaid syntax. The svg_url and png_url modes build public links via mermaid.ink, so for sensitive diagrams use base64, svg or file. The file output mode saves png to disk. The sse and streamable transports open local ports, 3033 and 1122 by default.
How to disable. Remove the server entry from your MCP client config. If installed globally, uninstall the mcp-mermaid package with your package manager.
FAQ
In which formats is the diagram returned?
base64, svg, raw mermaid, a file on disk, and svg_url and png_url links via mermaid.ink.
Does the server validate syntax?
Yes, mermaid validation lets the model fix an error over a few rounds.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for Mermaid diagrams: renders a diagram in the browser with live reload and saves it as SVG, PNG or PDF
Mermaid CLI processes diagrams inside Markdown, creating SVG files and replacing diagram blocks with references to the images.
The official draw.io MCP server: an agent builds diagrams from XML or Mermaid and opens them in the draw.io editor
Smart Drawio
Smart Drawio Next
An MCP server and skill for editable draw.io diagrams: an agent generates XML from a prompt, validates references, repairs tags and applies themes
Excalidraw MCP Server
Excalidraw MCP Server, CLI & Agent Skill
A live Excalidraw canvas for the agent: creates, edits and exports diagrams over MCP or CLI, sees its own work via screenshots and saves .excalidraw files into
A local document base for your agent: hybrid semantic and keyword search plus a web UI for browsing and uploads
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP Mermaid (this card) | no | not required | 649 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README shows a config for desktop clients via npx, separate for macOS and Windows, and running with sse or streamable transport after a global install. It lists output formats, CLI options for transport, port and endpoint, and a Docker run. Related projects mcp-server-chart and Infographic are noted. MIT licensed.