tech.unravel/mcp-mermaidjs-server

@unravel-team

About tech.unravel/mcp-mermaidjs-server

An MCP server for working with MermaidJS, using `mmdc`.

Config

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

{
  "mcpServers": {
    "mcp-mermaidjs-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "java",
        "-Dclojure.tools.logging.factory=clojure.tools.logging.impl/log4j2-factory",
        "-Dorg.eclipse.jetty.util.log.class=org.eclipse.jetty.util.log.Slf4jLog",
        "-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector",
        "-Dlog4j2.configurationFile=log4j2-mcp.xml",
        "-Dbabashka.json.provider=metosin/jsonista",
        "-Dlogging.level=INFO",
        "-Dmcp.vegalite.mmdc_executable=/Users/vedang/.local/share/nvm/v23.11.0/bin/mmdc",
        "-cp",
        "/Users/vedang/repo-name/target/tech.unravel/mcp-mermaidjs-server-1.0.0.jar",
        "tech.unravel.mcp-mermaidjs-server"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is tech.unravel/mcp-mermaidjs-server?

An MCP server for working with MermaidJS diagrams, using the mmdc CLI tool. It provides two tools—save-diagram and visualize-diagram—so an AI host can create a Mermaid spec, save it, then render it to a specific output format with optional custom CSS. It is built in Clojure and packaged as an uberjar.

How to use tech.unravel/mcp-mermaidjs-server?

Pre‑requisite: the mmdc CLI must be installed. Build the uberjar with make clean && make build, then configure the server in Claude Desktop or MCP Inspector using the provided JSON with the full path to the JAR and the mmdc executable.

Key features of tech.unravel/mcp-mermaidjs-server

Provides two tools: save-diagram and visualize-diagram
Renders Mermaid specs via mmdc CLI
Supports custom output format and optional CSS
Built with Clojure, runs as a Java process
Integrates with Claude Desktop and MCP Inspector

Use cases of tech.unravel/mcp-mermaidjs-server

Create and save a MermaidJS sequence diagram from a textual spec
Render a saved spec to a specific image format with optional styling
Automate diagram generation within an AI‑assisted workflow

FAQ from tech.unravel/mcp-mermaidjs-server

What does the server do?

It is an MCP server that wraps mmdc to let an AI host create, save, and render MermaidJS diagrams.

What are the prerequisites?

The mmdc CLI must be installed on the system before running the server.

How do I install the server?

Build the uberjar by running make clean && make build, then configure the full path to the JAR and to mmdc in your MCP client.

What output formats are supported?

The server delegates rendering to mmdc, which supports multiple output formats such as PNG, SVG, and PDF (the exact list depends on the mmdc installation and configuration).

Where are diagrams stored?

Diagrams are saved as .mmd files on the local filesystem; the save-diagram tool writes the spec to disk, and visualize-diagram reads that file to render it.

Frequently asked questions

What does the server do?

It is an MCP server that wraps `mmdc` to let an AI host create, save, and render MermaidJS diagrams.

What are the prerequisites?

The `mmdc` CLI must be installed on the system before running the server.

How do I install the server?

Build the uberjar by running `make clean && make build`, then configure the full path to the JAR and to `mmdc` in your MCP client.

What output formats are supported?

The server delegates rendering to `mmdc`, which supports multiple output formats such as PNG, SVG, and PDF (the exact list depends on the `mmdc` installation and configuration).

Where are diagrams stored?

Diagrams are saved as `.mmd` files on the local filesystem; the save-diagram tool writes the spec to disk, and visualize-diagram reads that file to render it.

Comments

Basic information

More Other MCP servers

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

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.

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep