hustcc/mcp-mermaid

Generate mermaid diagram and chart with AI MCP dynamically. Also you can use:
- mcp-server-chart to generate chart, graph, map.
- Infographic to generate infographic, such as Timeline, Comparison, List, Process and so on.
- 🖼️ figure.ling.pub/gallery to browse and share AI-generated diagrams and figures created with mcp-mermaid and other tools.
✨ Features
- Fully support all features and syntax of Mermaid.
- Support configuration of backgroundColor and theme, enabling large AI models to output rich style configurations.
- Support exporting to base64, svg, mermaid, file, and remote-friendly svg_url, png_url formats, with validation for Mermaid to facilitate the model's multi-round output of correct syntax and graphics. Use outputType: "file" to automatically save PNG diagrams to disk for AI agents, or the URL modes to share diagrams through public mermaid.ink links.
🤖 Usage
To use with Desktop APP, such as Claude, VSCode, Cline, Cherry Studio, and so on, add the MCP server config below. On Mac system:
On Window system:
Also, you can use it on aliyun, modelscope, glama.ai, smithery.ai or others with HTTP, SSE Protocol.
**Access Points:**
- SSE: http://localhost:3033/sse
- Streamable: http://localhost:1122/mcp
**Available Docker Tags:**
- susuperli/mcp-mermaid:latest - Latest stable version
- View all available tags at Docker Hub
🚰 Run with SSE or Streamable transport
Option 1: Global Installation
Install the package globally:
Run the server with your preferred transport option:
Option 2: Local Development
If you're working with the source code locally:
Access Points
Then you can access the server at:
- SSE transport: http://localhost:3033/sse
- Streamable transport: http://localhost:1122/mcp (local) or http://localhost:3033/mcp (global)
🎮 CLI Options
You can also use the following CLI options when running the MCP server. Command options by run cli with -h.
🔨 Development
Install dependencies:
Build the server:
Start the MCP server