关于 tech.unravel/mcp-mermaidjs-server
这是一个面向开发者和技术写作者的 Mermaid.js MCP 服务,主打"用写代码的方式画图"。你只需在文本里写出类似 flowchart、sequenceDiagram、classDiagram、gantt、erDiagram 等声明式语法,服务就能即时渲染出对应的矢量图,直接放进 README、技术博客、设计文档、Confluence 或 Notion 页面里。
典型使用场景包括:API 调用链时序图、系统架构流程图、数据库 ER 关系图、项目排期甘特图、状态机与迁移流程等。
它能帮你做什么
- 代码即图:纯文本语法描述结构,告别拖拽画图工具。
- 多图类型覆盖:流程图、时序图、类图、状态图、甘特图、饼图、Git 分支图等。
- 主题与样式可定制:支持主题切换(default / dark / forest / neutral)和 CSS 变量微调配色字体。
- 标准 SVG 输出:输出可缩放矢量图,文字可选中、可被屏幕阅读器解析,对技术文档友好。
- 批量与自动化:MCP 接口便于在 CI、文档生成流水线中批量出图。
- 外部依赖图:可结合 IDE、Agent 或文档站调用,插入渲染图链接或 base64。
是否需要密钥
Mermaid.js 本身是开源渲染引擎,本地 / 自托管部署通常无需任何 token,只要 Node.js 环境即可。如果你使用的是官方 Mermaid Live Editor 的受托管公共实例,可能受其速率限制;遇到 429 报错时建议改为本地启动的 @mermaid-js/mermaid-cli 或自建渲染服务。
对于 MCP 调用端,只要该服务以本地 stdio / SSE 方式运行在受信环境内,同样不需要 API Key;只有将渲染任务转交给第三方商业平台(如部分在线 Mermaid 渲染 API)时才需要鉴权 token,请按部署方说明配置。