mcp-mermaid-image-gen

# MCP Mermaid Image Gen An MCP server that generates diagrams from Mermaid code in multiple formats (primarily PNG and PDF, with SVG also available). This server enables AI assistants and other MCP clients to create diagrams using the Mermaid diagram syntax, with support for multiple themes, formats, and customizable backgrounds. ## Overview This MCP server wraps the Mermaid CLI (`@mermaid-js/mermaid-cli`) to provide diagram generation capabilities through the Model Context Protocol (MCP). It offers two operation modes: 1. File-based: Save diagrams to disk and return the file path 2. Stream-based: Return the diagram directly as base64-encoded data Both modes work with either STDIO or SSE transport, but the stream-based mode requires an MCP client capable of handling image data. The server is designed to be used by AI coding assistants and other tools that support the MCP protocol, allowing them to generate diagrams without needing direct access to the Mermaid CLI. ## Features - Generate diagrams from Mermaid syntax (flowcharts, sequence diagrams, class diagrams, etc.) - Multiple output formats: - PNG: Raster graphics, recommended for general use and broad compatibility. - PDF: Document format, perfect for print and formal documentation. - SVG: Vector graphics, available for web and scalable diagrams where specifically needed. - Support for multiple themes (default, neutral, dark, forest, base) - Customizable background colors (hex codes or named colors) - Two operation modes (both available in STDIO and SSE transport): - File-based: Save diagrams to disk and return the path - Stream-based: Return base64-encoded diagram data (requires MCP client with image support) - Comprehensive error handling and validation - Detailed logging with configurable levels ## Prerequisites for Use Before configuring your MCP client, ensure you have the following installed on your system: - **Node.js**: Version 14 or higher. - **Mermaid CLI**: Install globally using…