Advertise
MCP.so
Sign In

Mermaid MCP Server

@andrewginns

Repository

Basic information

Category

Other

Transports

stdio

Author

andrewginns

About Mermaid MCP Server

Python MCP Server abstracting the official mermaid-cli for ease of use

#mermaid#mcp-server#diagram-validation

Mermaid MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mermaid-mcp-server-andrewginns": {
      "command": "npx",
      "args": [
        "@mermaid-js/mermaid-cli",
        "--version"
      ]
    }
  }
}

Mermaid MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Mermaid MCP Server?

Mermaid MCP Server is a Model Context Protocol (MCP) server that validates Mermaid diagram syntax and optionally renders them as PNG images. It wraps the Mermaid CLI tool to provide LLMs with structured validation results, including boolean status, detailed error messages, and optional base64‑encoded images. Designed for developers integrating diagram validation into AI workflows.

How to use Mermaid MCP Server?

Configure the server in your MCP client (e.g., Claude Desktop) using uv and the provided Python script. The server exposes a single tool validate_mermaid_diagram that accepts diagram_text (required) and return_image (optional, default false). Example configuration JSON is included in the README, and local testing can be done via make install and make test.

Key features of Mermaid MCP Server

  • Validates Mermaid diagram syntax with structured error messages
  • Optionally returns base64-encoded PNG images of diagrams
  • Manages temporary files, puppeteer config, and command construction automatically
  • Context‑length optimised (images disabled by default)
  • Supports standard stdio transport for MCP clients
  • Includes a Pydantic AI test client using Gemini models

Use cases of Mermaid MCP Server

  • AI‑powered diagramming assistants that validate user‑provided Mermaid syntax
  • Automated documentation pipelines that verify diagram correctness before rendering
  • LLM agents that need to generate and visually confirm Mermaid diagrams

Frequently asked questions

1

What does the server validate?

It validates Mermaid diagram syntax using the Mermaid CLI. Returns `is_valid: true/false` and a detailed error message if validation fails.

2

What are the runtime dependencies?

Node.js with npm, Mermaid CLI (`npm install -g @mermaid-js/mermaid-cli`), and Python with `uv`. All are required even if only using the server component.

3

Why does the tool not return an image by default?

Returning images (base64 strings) can consume significant LLM context length (10KB–100KB+). Disabling images by default preserves context for longer conversations.

4

How are temporary files handled?

The server automatically creates and cleans up temporary `.mmd` and `.png` files, generates puppeteer configuration, and manages subprocess commands. No manual file management is needed.

5

Can I test the server locally?

Yes. Use `make install` to set up dependencies and `make test` to run validation tests. A test script using Pydantic AI with Gemini models is also provided.

Comments

More Other MCP servers

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise