home / mcp / mermaid grammer inspector mcp server

Mermaid Grammer Inspector MCP Server

Validates Mermaid diagrams and provides comprehensive grammar checks via MCP endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "betterhyq-mermaid-grammer-inspector-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mermaid-grammer-inspector"
      ]
    }
  }
}

You can run the Mermaid Grammer Inspector as an MCP server to validate Mermaid diagram syntax and perform thorough grammar checks. It exposes a stable interface you can connect to from MCP clients, enabling real-time feedback and error reporting for Mermaid diagrams.

How to use

Connect to the Mermaid Grammer Inspector MCP server from your MCP client to start validating Mermaid diagrams. You will run the local server as a stdio process and connect via an MCP client, or run it as a foreground HTTP service and communicate over a remote HTTP endpoint. Once connected, you can submit Mermaid diagram snippets and receive detailed validation results, including syntax errors and grammar-level feedback, which helps you fix issues quickly.

How to install

Prerequisites: Node.js (with npm) or any environment capable of running npx. Ensure you have network access to install packages.

# npm
npm install -g mermaid-grammer-inspector-mcp

# yarn
yarn add -g mermaid-grammer-inspector-mcp

# pnpm
pnpm add -g mermaid-grammer-inspector-mcp

# bun
bun install -g mermaid-grammer-inspector-mcp

# deno
deno install -g npm:mermaid-grammer-inspector-mcp

Configuration and usage notes

You can run the server locally as a stdio MCP server. Use the following configuration to connect from an MCP client, or run the server directly and connect via a local npx path.

{
  "mcpServers": {
    "mermaid_grammer": {
      "command": "npx",
      "type": "stdio",
      "transportType": "stdio",
      "args": [
        "-y",
        "mermaid-grammer-inspector"
      ]
    }
  }
}

Available tools

validateMermaid

Validates Mermaid diagrams for syntax errors and reports detailed grammar issues with line/column information to guide quick fixes.

grammarCheck

Performs comprehensive grammar checks, highlighting invalid tokens, structural issues, and relationship errors in Mermaid diagrams to improve diagram quality.