tech.unravel/mcp-mermaidjs-server

Name: tech.unravel/mcp-mermaidjs-server
Author: unravel-team

@unravel-team

Repository

About tech.unravel/mcp-mermaidjs-server

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

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.