使用 tech.unravel/mcp-mermaidjs-server 的 MCP 服务器与 MermaidJS 工作

使用 mmdc 创建一个为 MermaidJS 工作的 MCP 服务器。

我们创建了两个简单的工具：

• save-diagram
• visualize-diagram

通过这些工具，主机可以按照以下步骤生成精美的 MermaidJS 图表：

1. 创建一个 mmd 规格并保存它
2. 使用指定的输出格式（可选）和 CSS（通过访问 mmdc）渲染已保存的规格

使用方法

构建 Uberjar

1. 运行 make clean && make build

运行 MCP 服务器

前提条件： 需要安装 mmdc CLI。

以下是一些可以在 Claude Desktop 或 Inspector 中尝试的示例命令：

1. 根据以下规格创建一个 MermaidJS 的流程图：

sequenceDiagram
%% 请参阅 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

在运行 MCP 服务器之前

注意事项：

1. 替换 /Users/vedang/repo-name 为系统上的 tech.unravel/mcp-mermaidjs-server JAR 的正确路径。
2. 指定系统上 mmdc 的完整路径。

在 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"
      ]
    }

在 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

许可证

本项目使用 MIT 许可证，详情请参阅 LICENSE。