Mermaid MCP Server

Example Use Cases

• 1

  Convert textual Mermaid diagram descriptions into PNG or SVG images for inclusion in messages or documents.

• 2

  Generate themed diagrams (default, forest, dark, neutral) or apply custom background colors programmatically.

• 3

  Either receive images inline (when CONTENT_IMAGE_SUPPORTED=true) or save rendered diagrams to disk for workflows where inline images are not supported (CONTENT_IMAGE_SUPPORTED=false).

Description

This MCP server renders Mermaid diagrams using a headless browser (Puppeteer), producing high-quality SVGs or PNG screenshots. It supports multiple themes, customizable background colors, and can either return images inline or save them to disk based on environment configuration. The server is designed for easy integration with MCP-capable clients (examples: Claude Desktop, Cursor, Smithery) and includes options to handle Docker/Chromium deployment nuances. Error handling and flexible output options make it suitable for automated diagram generation in agent workflows.

Capabilities(4 total)