tech.unravel/mcp-mermaidjs-server

基本能力

产品定位

mcp-mermaidjs-server 是一个专门用于处理 MermaidJS 图表的 MCP 服务，通过集成 mmdc 工具，提供图表的保存和可视化功能。

核心功能

1. 创建 MermaidJS 图表：支持用户创建 MermaidJS 规范并保存为图表。
2. 渲染图表：支持将保存的图表规范渲染为指定格式的输出，并可自定义 CSS。
3. 工具支持：提供 save-diagram 和 visualize-diagram 两个工具，简化图表创建和渲染流程。

适用场景

1. 技术文档生成：用于生成技术文档中的流程图、序列图等。
2. 数据可视化：将复杂的数据关系通过图表形式直观展示。
3. 开发工具集成：集成到开发工具中，提供图表生成和渲染功能。

工具列表

1. save-diagram：用于保存 MermaidJS 图表规范。
2. visualize-diagram：用于渲染保存的图表规范为指定格式的输出。

常见问题解答

1. 依赖问题：需要预先安装 mmdc CLI 工具。
2. 路径配置：运行服务时需要指定 mmdc 和 JAR 文件的完整路径。

使用教程

使用依赖

1. 安装 mmdc CLI 工具： shell npm install -g @mermaid-js/mermaid-cli

安装教程

1. 构建 Uberjar： shell make clean && make build
2. 运行 MCP 服务： shell 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=/path/to/mmdc -cp /path/to/mcp-mermaidjs-server.jar tech.unravel.mcp-mermaidjs-server

调试方式

1. 检查 mmdc 是否安装成功： shell mmdc --version
2. 检查服务是否正常运行： shell curl http://localhost:8080/health

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。