Server facts
mcp-mermaid-validator
Project
- Author
- rtuin
- Repository
- github.com/rtuin/mcp-mermaid-validator
- License
- MIT
- Category
- Design & Creative
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.