generate
Generate PNG image or SVG from mermaid markdown
LABSCO SUMMARY
A diagram drafted in a conversation ends up as a file the repository can reference.
One tool, and its arguments cover what actually varies between renders: format, theme, background colour, folder and name. That makes it worth leaving installed — the drafting and the rendering stop being two separate places, and the diagram in the message is the same artefact as the one in the docs.
What it is
A single-tool server that renders mermaid markdown to an image file.
What you get
- A diagram rendered from mermaid markdown as a PNG or an SVG
- Theme and background colour chosen per render, so the image suits the document it is going into
- The output folder and filename given in the call, so the file lands where the document already expects it
Requirements
The mermaid markdown itself; no account or key. One setting matters: Cursor and Cline need CONTENT_IMAGE_SUPPORTED set to false, as in their tabs, and the image is then saved to a folder you name instead of returned inline.
Setup effort
Add the configuration to your client
USE CASES
01
Getting a drafted diagram into the docs
The diagram written in the message becomes a file on disk in the format the document needs, named and themed in the same call, so nobody has to redraw it somewhere else.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected. With CONTENT_IMAGE_SUPPORTED at its default of true, generate returns the image inline. Cursor and Cline need it set to false, which writes the file to disk and makes the name and folder parameters mandatory.
Requires
npx on PATH
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mermaid": {
"command": "npx",
"args": [
"-y",
"@peng-shawn/mermaid-mcp-server"
]
}
}
}Cursor, Cline
JSON
{
"mcpServers": {
"mermaid": {
"command": "npx",
"args": [
"-y",
"@peng-shawn/mermaid-mcp-server"
],
"env": {
"CONTENT_IMAGE_SUPPORTED": "false"
}
}
}
}
