Diagram Design
БесплатноНе проверен编辑级图表设计系统 MCP:45 类图表目录、8 个工具、82 个单色图标;产出自足单文件 HTML+SVG,扁平 schema 兼容严格模型;暗色主题与无障碍契约,77 项测试。
Описание
编辑级图表设计系统 MCP:45 类图表目录、8 个工具、82 个单色图标;产出自足单文件 HTML+SVG,扁平 schema 兼容严格模型;暗色主题与无障碍契约,77 项测试。
README
把架构图、流程图、时序图、状态机、象限图等 45 类图表画成自足单文件 HTML+SVG 的编辑级设计系统,以 MCP 服务的形式提供。
一个 8 工具的 MCP 服务器:查设计规范、取图标、搭合规骨架、跑机械自检、从既有图提取结构、合成图库页。
为什么是 MCP
原本这套东西是 DeepSeek Harness 插件(dsh-diagram-design)。插件只能在一个宿主里用;MCP 协议让同一套能力对任何支持 MCP 的客户端开放——WorkBuddy、Claude Code、Cursor、自己写的 agent 都行。
设计约束
内容进、内容出
服务端不读写调用方的文件系统。每个工具接收文档文本,返回文本。文件由宿主读、由宿主写。
这不是偷懒,是刻意的:服务因此可以跑在任何地方(本包实际部署在一台安卓手机的 Termux 里),路径穿越风险归零,多客户端共享一个实例也不会互相踩文件。
扁平 schema
严格上游模型会因为工具定义里有 outputSchema / anyOf / oneOf 就直接拒掉整个请求,工具静默不可用——报错码还长得像"参数不合法",能查一整天。
所以这里的 schema 全部手写、扁平,只用 type / properties / required / enum / items。可选参数就是"不在 required 里",绝不用联合类型表达。test/tools.test.mjs 断言了这个约束,防止以后有人顺手改坏。
工具
| 工具 | 干什么 |
|---|---|
diagram_tokens |
取权威设计数值:语义角色(明/暗)、节点处理、排版、描边/圆角/网格、复杂度预算(含动效上限)、六条连线铁律、反模式、对比度契约、终端皮肤 |
diagram_sizes |
取尺寸预设(viewBox 与字号绑定)、排版阶梯、安全区、四个输出旋钮、降级顺序、宿主 CSS 契约 |
diagram_types |
查 45 类目录:标准工作流(L0 导航)、选型指南、语义模式(五要素全文)、逐类型预算上限、每类的布局约定/预算/反模式/具名章节。支持中文关键词(「时序」「象限」) |
diagram_icons |
取内置图标库:82 个单色 24×24 图标 / 12 组,currentColor 自动跟皮肤。默认只回便宜的索引,点名 names 才回 <svg> 标记;中文别名(「数据库」「防火墙」)可直接搜 |
diagram_scaffold |
生成落地即合规的骨架 HTML(无障碍契约、箭头标记、宿主 CSS、图例条、4px 网格都放好了) |
diagram_check |
机械自检。报告分 findings(机械判定,error 必须修)/ judgement(编辑判断,是你的责任)/ limits(查不出什么) |
diagram_import |
从 Mermaid / draw.io / Excalidraw 提取结构(不渲染)。Markdown 只认顶层 mermaid 围栏,多块用 block 参数选 |
diagram_gallery |
把多张图合成自足图库页,内嵌 iframe sandbox="" srcdoc 隔离预览 + 自检结论 |
图标库为什么是内置数据
服务端读不到调用方的文件系统,所以图标不能照上游那样写成 references/primitive-icons.md 让 agent 去 Read——那条路在 MCP 形态下是死的(本包实际部署在一台安卓手机上)。82 个图标因此被机械解析进 src/core/icons.json,由 diagram_icons 把 <svg> 标记直接发回去。再生成:
npm run icons -- /path/to/cathrynlavery/diagram-design/skills/diagram-design/references/primitive-icons.md
只收许可证允许再分发的来源:Tabler Icons(MIT)、Simple Icons(CC0)、Devicon(MIT)、log-z/logos(MIT)。上游自己标着 verify license before use 的 5 个(hop / pentaho / dagster / sas / stata)没有收录——未确权的图形不能借本包的 MIT 名义分发,icons.json 的 excluded 字段记着每一条的原因,测试也钉着这个白名单。
45 类目录(catalog.json)同理是生成物:scripts/build-catalog.mjs 从上游类型文档收割(布局约定、预算、反模式、Containment 等具名章节、语义模式五要素全文、逐类型预算表),L0 面可见的规范在生成时全部内联,目录里凡出现 .md 引用都会被测试门禁拦下。再生成:
npm run catalog -- /path/to/cathrynlavery/diagram-design/skills/diagram-design
跑起来
npm install
# 必须设置 token —— 没设会拒绝启动,不会裸奔
export DIAGRAM_MCP_TOKEN=$(head -c 32 /dev/urandom | od -An -tx1 | tr -d ' \n')
export DIAGRAM_MCP_PORT=8400 # 默认 8400
export DIAGRAM_MCP_BIND=0.0.0.0 # 默认 0.0.0.0
npm start
或者用 deploy/run.sh(从同目录的 config.env 读配置,前台 exec——supervisor 负责重启)。
会话寿命
客户端很少主动断开:MCP SDK 自己的 client.close() 都不发 DELETE(实测确认,只有显式 terminateSession() 才发),进程被杀或掉网的客户端更发不出来。所以会话不能只靠 DELETE 回收——一台跑几周的机器上这就是无界泄漏(一次审计把会话数从 11 顶到 63,一个都没回收)。
| 环境变量 | 默认 | 作用 |
|---|---|---|
DIAGRAM_MCP_IDLE_MS |
1800000(30 分钟) |
空闲多久回收。任何流量都续命,只有彻底静默才过期 |
DIAGRAM_MCP_MAX_SESSIONS |
256 |
硬上限,到顶淘汰最久未用的,防止一波连接打爆内存 |
两者都会在 /health 里回显(idleMs / maxSessions),方便核对部署配置有没有真的生效。
run.sh用set -a导出整个config.env。不要改回裸. config.env——那样只设 shell 变量,子进程收不到,config.env里写的旋钮会静默失效而/health报默认值(踩过,diagram-mcp-ctl status现在有漂移检测专门抓这个)。
接入客户端
{
"mcpServers": {
"diagram-design": {
"type": "streamableHttp",
"url": "http://<host>:8400/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
/health 免鉴权,/mcp 需要 Bearer。
接入 WorkBuddy
配置文件放 mcp.json(Windows 上是 %USERPROFILE%\.workbuddy-ai\mcp.json;同目录还有一份 .workbuddy\mcp.json,实际生效的是 .workbuddy-ai 那份——旁边的 mcp-approvals.json、mcp-tool-list.json 都在那儿)。
用户自行添加的 MCP Server 默认不可信。 首次接入要在 UI 里显式确认一次:
设置 → 安全中心 → 工具控制 → 自定义 MCP("统一控制用户自行添加的 MCP Server")
那个页面会把 mcp.json 里的条目列出来,未确认的显示为不可信,点确认后写入 mcp-approvals.json。
两个容易踩的点:
- 配置不热重载。 改完
mcp.json要么重开应用,要么打开上面那个页面触发一次刷新(对应mcpRefresh通道)。直接改文件然后等,是等不到的。 - 信任键绑的是 URL 的 origin,不是完整 URL。 上游实现是
sha256(new URL(url).origin),再拼服务名——即diagram-design::sha256("http://<host>:8400")。所以/mcp路径改了不影响,端口或主机改了要重新确认一次。
// 信任键的推导(摘自应用实现)
function hashInput(cfg) { return cfg.kind === 'stdio' ? [...] : new URL(cfg.url).origin }
const key = `${name}::${sha256(hashInput(cfg))}`
测试
npm test # 单元:核心模块 + 工具契约 + HTTP 端到端 + 会话生命周期 + CLI 契约 + 对比度门禁
test/cli-contract.test.mjs 守两件事:三个远端脚本缺 DIAGRAM_MCP_URL 必须 exit 2 并点名该变量(不能把"忘配地址"伪装成网络错误),以及仓库里不许出现内网地址。它靠 spawnSync 拉起子进程——在禁 spawn 的沙箱里会显式 skip 并说明原因,不会假通过。
对已部署实例跑端到端冒烟(真实 MCP 客户端、握手、鉴权、8 工具全打一遍、并发会话):
DIAGRAM_MCP_URL=http://<host>:8400/mcp \
DIAGRAM_MCP_TOKEN=<token> \
node scripts/smoke-remote.mjs
两个变量都是必须的,没有默认值。 这三个脚本打的是部署实例,一个指向
localhost的假默认值只会把"你忘了配地址"变成一句看不懂的ECONNREFUSED。 若本机设了HTTP_PROXY,局域网地址会被代理拦掉(404)。用env -u HTTP_PROXY -u HTTPS_PROXY -u http_proxy -u https_proxy跑。
全量边界审计(异常 HTTP 请求、鉴权变体、极端入参、45 类 × 10 尺寸档 × 2 皮肤、皮肤承诺兑现、生成器↔检查器契约、恶意内容穿透、会话回收、并发压力):
DIAGRAM_MCP_URL=http://<host>:8400/mcp \
DIAGRAM_MCP_TOKEN=<token> \
DIAGRAM_MCP_EXPECT_MAX_SESSIONS=128 \
DIAGRAM_MCP_EXPECT_IDLE_MS=1800000 \
node scripts/audit.mjs
审计自己不留尾巴:它会故意造 15 个孤儿会话来验证回收与上限,但在断言成立后立刻清掉,并在结束时要求会话数回到基线。它连自己的主客户端会话也显式回收——client.close() 不发 DELETE,一个裸 close 就是每跑一次漏一个会话;而且它不吞终止失败(.catch(() => {}) 会把"清理失败"伪装成"服务端泄漏")。
两条基线断言是互补的:一条比本轮起点(会话回收是否工作),一条比审计开始前的绝对计数(跨轮有没有净增量)。只有前者时,泄漏会跟基线同步爬升而永远绿灯——实测基线 12 → 13 → 14 连过三轮。
DIAGRAM_MCP_EXPECT_* 是可选的,但部署后一定要带上:不带的话只验"/health 有这个字段",带了才验"值等于你配的"。少了这一层,配置漂移(变量名拼错、启动脚本漏导出)能一路绿灯放行。
重建 examples/ 里的示例图与图库页(同样打的是真实服务,任何一张有 error 就以非零码退出):
DIAGRAM_MCP_URL=http://<host>:8400/mcp \
DIAGRAM_MCP_TOKEN=<token> \
node scripts/build-examples.mjs
示例
examples/ 下是两张真图,都是走"选型 → 定尺寸 → 取令牌 → 搭骨架 → 自检"产出的,机械自检 0 error:
request-path.html—— 一次请求的链路(architecture)workflow.html—— 画一张图的标准顺序(flowchart)gallery.html—— 图库页,两张图的沙箱预览 + 各自的自检结论
打开 examples/gallery.html 就能看。
部署到安卓手机(Termux)
deploy/termux/ 下是两个运维脚本,与常见的 Termux 服务约定一致(tmux 会话 + while 循环 + 端口幂等检测):
diagram-mcp-guard—— 幂等启动,已跑则跳过;接进ubuntu-autostart即可开机自启。diagram-mcp-ctl——status/restart/stop/logs/token。
status 除了端口、健康、日志,还会做两件事:
- 配置漂移检测 —— 把
config.env里的DIAGRAM_MCP_*与运行进程的真实环境逐条比对。 - 配置 ↔
/health闭环 —— 确认代码真的读了那些变量(防变量名拼错:环境对了但/health还是默认值)。
这两道是补出来的。原先 config.env 里写了 DIAGRAM_MCP_IDLE_MS / DIAGRAM_MCP_MAX_SESSIONS,run.sh 却没导出它们,/health 一直报默认值——而当时所有测试都是绿的,因为断言只验"字段存在且为正数"。现在这种"运维配了、进程没收到"的情况会被直接点名。
这个服务是纯 Node + 一个依赖,直接跑在 Termux 层即可,不必进 proot——进 proot 只会多一层 --kill-on-exit 的坑(容器一退,守护全死)。
目录
icon.svg 仓库/包图标(用本包自己的令牌画的:paper 底 + ink 线 + accent 焦点,圆角 8 = radius-lg)
src/
server.mjs Streamable HTTP + 会话生命周期 + Bearer 鉴权
tools.js 8 个工具:纯数据 + 纯 handler
core/
tokens.js 设计令牌(语义角色、排版、网格、预算、连线铁律)
sizes.js 尺寸预设、排版阶梯、安全区、旋钮、降级顺序
check.js 品味关卡:机械可判定部分
scaffold.js 合规骨架生成器
import.js Mermaid / draw.io / Excalidraw 解析器
catalog.json 45 类图表目录
icons.json 82 个图标(名字、说明、中文别名、`<svg>` 标记、来源与许可)
test/ 77 项(含 CLI 契约、图标库门禁、对比度门禁;禁 spawn 的沙箱里 2 项显式 skip)
scripts/ smoke-remote.mjs · audit.mjs · build-examples.mjs · build-catalog.mjs · build-icons.mjs(再生成 catalog.json / icons.json)
examples/ 两张真图 + 图库页
deploy/ run.sh + Termux 守护脚本
skill/ 技能入口(通用 name/description 格式,任何支持技能的宿主可装)
已知边界
- 服务端无文件系统访问,所以
diagram_check要传 HTML 全文而不是路径——图很大的时候 token 开销实打实。 - 机械自检只查能机械判定的部分。"通过"不等于"图很好",编辑判断仍然是人(或模型)的责任。工具会明确列出自己覆盖不到什么。
- 中文标签需要自己扩展字族:Geist 无汉字覆盖。字号下限 12px,装不下就砍名字,不要缩字号。
许可与来源
MIT。派生链:cathrynlavery/diagram-design → dsh-diagram-design → 本包。详见 NOTICE.md。
Установка Diagram Design
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/zhaopq123/diagram-design-mcpFAQ
Diagram Design MCP бесплатный?
Да, Diagram Design MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Diagram Design?
Нет, Diagram Design работает без API-ключей и переменных окружения.
Diagram Design — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Diagram Design в Claude Desktop, Claude Code или Cursor?
Открой Diagram Design на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
LibreOffice Tools
Enables AI agents to read, write, and edit Office documents via LibreOffice with token-efficient design. Supports multiple formats including DOCX, XLSX, PPTX, a
автор: passerbyflutterFigma
Extract design specs and assets
автор: Figmadannote/figma-use
Figma control: create shapes, text and components, and set styles, auto-layout, variables and exports.
автор: dannoteLogo.dev
Search and retrieve company logos by brand or domain. Customize size, format, and theme to match your design needs. Accelerate design, prototyping, and content
автор: NOVA-3951Design Inspiration Server
Searches top design platforms like Dribbble and Behance to provide UI inspiration, color palettes, and layout patterns via the Serper API. It allows users to re
автор: YonasValentinPIX4Dmatic
Enables GUI automation for controlling PIX4Dmatic on Windows through MCP. Supports launching, focusing, capturing screenshots, sending hotkeys, clicking UI elem
автор: jangjo123Codebase Onboarder
Drop a path. Get a map. A zero-dependency codebase visualizer with a CLI onboarding wizard, a web UI, and an optional key-gated self-hosted mode.
автор: its.amitmcp-dockmaster
An Open-Sourced UI to install and manage MCP servers for Windows, Linux and macOS.
ariekogan/ateam-mcp
Build, validate and deploy multi-agent AI solutions on the ADAS platform: design skills with tools and manage the solution lifecycle.
автор: ariekoganthinkchainai/mcpbundles
Create custom tool bundles, connect providers with OAuth or API keys, and use one MCP server across many integrations, with a UI for bundles and credentials.
автор: thinkchainaiCompare Diagram Design with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории design
