进阶 next-ai-drawio.jiang.jp 2026-11-15 12:26:06 · 13 阅读
第9章 在 Claude Code 里画 draw.io 图表(MCP)
一条命令就能把 draw.io MCP 服务器加到 Claude Code 里。Claude 在您浏览器里的实时画布上画图;您可以手动修改,Claude 会读取您的改动。
安装
需要 Node.js 18 或更高版本。在终端里运行:
claude mcp add --scope user drawio -- npx @next-ai-drawio/mcp-server@latest
--scope user 让所有项目都能用这些工具。不加的话,只有在运行命令的那个文件夹里才能用。
也可以从 Claude Code 社区插件市场把它作为插件安装(需要 Claude Code 2.1.275 或更高版本):
/plugin install next-ai-drawio --marketplace anthropics/claude-plugins-community
新开一个 Claude Code 会话。连接成功后,/mcp 会列出 drawio。
Codex、VS Code、Cursor 和其他客户端的用法,见 MCP 服务器 README。
画第一张图
请 Claude 把它能读到的内容画成图:
读一下这个仓库,画出它的架构
Claude 会用自己的工具读取代码,在您的浏览器里打开预览,并在那里画图。较大的图表会分几次画完,您可以看到它逐步成形。
其他效果不错的请求:
“把结账 API 的请求流程画成时序图”
“把 docs/architecture.md 转成带 AWS 图标的图表”
“打开 diagrams/system.drawio,加上新的队列服务”
claude> AWS CloudAWS CloudCognitoCognitoAPI GatewayAPI GatewayLambdaLambdaDynamoDBDynamoDBS3S3ElastiCacheElastiCacheUsersUsersHTTPSHTTPSfilesfilescache readscache readsText is not SVG - cannot display
一起修改图表
手动编辑。 预览就是完整的 draw.io 编辑器。您可以移动图形、修改标签或更改样式;Claude 再次编辑前会读取图表,包括您的改动。
选中图形。 在预览里选中图形,然后说“把这些改成蓝色”或“把这个拆成两个服务”。Claude 会读取您选中的内容。
查看改动。 Claude 的修改会被框出几秒钟。在预览里按 Ctrl+Z,可以撤回它的上一次修改。
回到更早的版本。 最近 20 个版本以卡片形式显示在画布旁边,您可以对比或恢复其中一个。也可以让 Claude 撤销。
保存和导出
每次修改都会保存到 ~/.next-ai-drawio/.drawio,连同最近 20 个版本;最新的 50 张图表会被保留。想在之后的对话里继续画某张图,告诉 Claude 您要哪张图即可:它会找到保存的图表并重新打开。
需要文件时,请让 Claude 导出:.drawio、.png、.svg 或 .drawio.svg。.drawio.svg 文件是一张图片,draw.io 也能打开和编辑它,适合放在 README 文件里。
自己的画图规则
把规则写在 ~/.next-ai-drawio/instructions.md 里,例如“始终使用简约风格”。每次调用时,这些规则都会加到绘图指南里,所以修改规则后无需重启就会生效。只读取前 5000 个字符。
设置
环境变量可以改变服务器的工作方式。添加服务器时用 -e 传入:
claude mcp add --scope user drawio -e DRAWIO_LANG=ja -- npx @next-ai-drawio/mcp-server@latest
变量默认值作用PORT6002预览端口;被占用时,会使用下一个空闲端口,最高到 6020DRAWIO_DATA_DIR~/.next-ai-drawio保存图表和 instructions.md 的文件夹;设为 off 则不保存DRAWIO_AUTO_SCREENSHOT未设置设为 true 时,每次创建和编辑的结果都会附带一张截图(每次调用 2 到 10 秒)DRAWIO_LANG未设置固定编辑器和预览的语言:en、zh、zh-tw、ja、de 等DRAWIO_DARKauto1 以深色启动,0 以浅色启动,auto 跟随系统BROWSER未设置设为 none 时不会自动打开预览DRAWIO_ALLOW_EMBED未设置设为 true 时,允许本机(localhost、127.0.0.1)上的页面嵌入预览,例如 DeepSeek Harness 的侧栏浏览器
所有变量,以及如何使用自建的 draw.io,见 MCP 服务器 README。
问题排查
预览没有打开。 向 Claude 要预览的 URL,然后自己打开;URL 里的 ?mcp= 部分会把页面连接到这个会话。
在 VS Code 的 Simple Browser 或 Cursor 的浏览器里,预览一片空白。 这个页面不允许被嵌入到其他页面中。请在普通浏览器里打开这个 URL。
截图或 PNG/SVG 导出超时。 它们由预览标签页渲染,而浏览器会降低后台标签页的运行速度。请把这个标签页切到前台,再试一次。
“No active session”。 Claude 需要先启动会话;请让它重新启动 drawio 会话。