mcp-mermaid-validator

Mermaid Validator MCP Server

Mermaid diagram checking and PNG rendering are available to LLMs and MCP-compatible clients through mcp-mermaid-validator. Its validateMermaid tool accepts diagram source and returns either a rendered image with confirmation or validation error details.

Server facts

mcp-mermaid-validator

Project

Author
rtuin
License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
57
Last commit
Data as of

Tags

  • diagram rendering
  • mcp
  • mermaid validator

Overview

Mermaid source can be checked and turned into an image through the validateMermaid tool exposed by mcp-mermaid-validator. The tool takes a string containing diagram syntax and delegates validation and rendering to Mermaid CLI. When processing succeeds, the response includes a text confirmation and a PNG encoded as base64. When a diagram fails validation, the response instead contains an invalidity notice, an error message, and detailed diagnostic output when available. This gives LLMs access to both diagram output and failure information within an MCP interaction.

The implementation is a TypeScript application running on Node.js, with the MCP SDK providing its client-facing interface. Communication with compatible clients uses standard input and output, while a child process runs Mermaid CLI and captures its output and errors. Error handling distinguishes diagram syntax problems from system-level failures. The documented configuration launches the package through npx. For development, the repository also documents compilation, formatting, linting, watch mode, and local inspection with MCP Inspector.

mcp-mermaid-validator setup notes

  • mcp-mermaid-validator records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers