What is Mermail Mcp

mermail-mcp is a Flask server that generates diagrams from Mermaid syntax using mermaid-cli, allowing users to easily create visual representations of their data and processes.

Use cases

Use cases for mermail-mcp include generating flowcharts for software processes, creating organizational charts for businesses, and visualizing data flows in data science projects.

How to use

To use mermail-mcp, clone the repository, install the required Python dependencies, ensure mermaid-cli is installed globally, and then run the server using ‘python server.py’. Access the web interface at ‘http://localhost:5000’ or send a POST request to the ‘/generate’ API endpoint with your Mermaid diagram in JSON format.

Key features

Key features of mermail-mcp include support for generating diagrams from Mermaid syntax, a web interface for easy access, customizable themes and backgrounds for diagrams, and automatic cleanup of temporary files.

Where to use

mermail-mcp can be used in various fields such as software development for visualizing architecture, project management for illustrating workflows, and education for teaching concepts through diagrams.

Mermaid Diagram Generator Server

A simple Flask server that generates diagrams from Mermaid syntax using mermaid-cli.

Prerequisites

• Python 3.7+
• Node.js and npm (for mermaid-cli)
• mermaid-cli installed globally: npm install -g @mermaid-js/mermaid-cli

Installation

1. Clone this repository
2. Install Python dependencies:

   pip install -r requirements.txt
   

3. Ensure mermaid-cli is installed globally:

   npm install -g @mermaid-js/mermaid-cli
   

Running the Server

Start the server with:

python server.py

By default, the server runs on http://localhost:5000.

Temporary Files

The server creates a local directory called temp_files in the project folder for storing temporary files. This approach:

• Avoids permission issues with system temp directories
• Works better in virtual environments
• Automatically cleans up files older than 30 minutes

API Usage

Web Interface

Open your browser and navigate to http://localhost:5000 to use the web interface.

API Endpoint

Send a POST request to /generate with a JSON body containing your Mermaid diagram:

The server will return a PNG image of the rendered diagram.

Example using curl:

curl -X POST http://localhost:5000/generate \
  -H "Content-Type: application/json" \
  -d '{"mermaid":"graph TD\nA[Client] --> B[Load Balancer]"}' \
  --output diagram.png

Testing

Run the included test script to verify everything is working:

python test.py

This will generate a sample diagram and save it as output_diagram.png.

Troubleshooting

If you encounter errors:

1. Ensure mermaid-cli (mmdc) is installed and accessible in your PATH
2. Check server logs for specific error messages
3. Make sure your Mermaid syntax is valid
4. Verify the temp_files directory exists and has appropriate permissions