MCP Mermaidjs Server

🚀 Working with MCP Server for MermaidJS using tech.unravel/mcp-mermaidjs-server

Create an MCP server for MermaidJS using mmdc.

We've developed two simple tools:

• save-diagram
• visualize-diagram

With these tools, the host can generate beautiful MermaidJS diagrams following these steps:

1. Create an .mmd specification and save it.
2. Render the saved specification using the specified output format (optional) and CSS (by accessing mmdc).

🚀 Quick Start

📦 Installation

Build Uberjar

1. Run make clean && make build

Run MCP Server

Prerequisite: You need to install mmdc CLI.

Here are some example commands you can try in Claude Desktop or Inspector:

1. Create a MermaidJS flowchart based on the following specification:

sequenceDiagram
%% Refer to https://mermaidjs.github.io/sequenceDiagram.html

loop 每天 D-2 工作日 16:00
    ABCD->>DEE: [14:25] BEE（每个 TC 直到 ACK 成为 OK 的计算）

    ABCD->>FGG: BEE（每个 TC 直到 ACK 成为 OK 的计算）
    Note over ABCD,FGG: D-2 工作日 14:25
    ABCD->>HII: 向 HII 投影授权
    Note over ABCD,HII: D-2 工作日 16:00
end

loop D-1 截止前 7:45
    HII->>DEE: 提交
    Note over HII,DEE: D-1 截止前
    HII->>FGG: 提交
    Note over HII,FGG: D-1 截止前
end

Before Running the MCP Server

Important Note:

1. Replace /Users/vedang/repo-name with the correct path to the tech.unravel/mcp-mermaidjs-server JAR on your system.
2. Specify the full path to mmdc on your system.

In Claude Desktop

    "mcp_mermaidjs_server": {
      "command": "java",
      "args": [
        "-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.jar",
        " tech.unravel.mcp.Main"
      ]
    }

In 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.jar \
  tech.unravel.mcp.Main

📄 License

This project is licensed under the MIT License. See LICENSE for details.