mermaid-mcp-server MCP Server

When working with a new codebase, it’s easy to lose time jumping between folders and files. This server provides a clean, tool-based workflow for agents to discover, read, and visualize a project —…

Local serverstdio

What is the mermaid-mcp-server MCP Server?

mermaid-mcp-server is an MCP project maintained in the gittyburstein/mermaid-mcp-server repository. The maintainer describes its purpose as “When working with a new codebase, it’s easy to lose time jumping between folders and files. This server provides a clean, tool-based workflow for agents…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using C:\Users\<YOU>\path\to\repo\.venv\Scripts\python.exe. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares PROJECT_ROOT, KROKI_BASE_URL, KROKI_TIMEOUT, DIAGRAM_OUT_DIR, MAX_FILE_CHARS. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the mermaid-mcp-server MCP Server

{
  "mcpServers": {
    "mermaid-mcp": {
      "command": "C:\\Users\\<YOU>\\path\\to\\repo\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<YOU>\\path\\to\\repo\\src\\server\\server.py"
      ],
      "env": {
        "PROJECT_ROOT": "C:\\Users\\<YOU>\\path\\to\\repo",
        "KROKI_BASE_URL": "https://kroki.io",
        "KROKI_TIMEOUT": "20",
        "DIAGRAM_OUT_DIR": "diagrams",
        "MAX_FILE_CHARS": "200000"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PROJECT_ROOTDeclared in the maintainer’s client configuration.Check documentation
KROKI_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
KROKI_TIMEOUTDeclared in the maintainer’s client configuration.Check documentation
DIAGRAM_OUT_DIRDeclared in the maintainer’s client configuration.Check documentation
MAX_FILE_CHARSDeclared in the maintainer’s client configuration.Check documentation