用MCP让AI替你画架构:Breakscale MCP服务器接入Claude与Cursor完整教程

📅 发布时间:2026/10/14 15:37:05
用MCP让AI替你画架构:Breakscale MCP服务器接入Claude与Cursor完整教程
【免费下载链接】breakscaleBuild a system, load it until it breaks, and watch why. A system design simulator for learning distributed systems.项目地址https://gitcode.com/gh_mirrors/br/breakscale点击查看免费下载Breakscale 是一个分布式系统模拟器它的MCP 服务器能让 Claude、Cursor 等 AI 助手直接读懂你的代码自动画出系统架构图再用真实的离散事件引擎压测 30 秒返回实测的延迟p99、吞吐量与失败原因并生成一个能在浏览器里直接打开的分享链接。换句话说你不用手写一张静态图只要开口问AI 就能画出架构 跑一遍压测 告诉你在哪里会崩。本文是一份面向新手的完整教程先讲清楚 Breakscale 和它的 MCP 服务器是怎么工作的再手把手带你把Claude和Cursor接上最后给出一批问完立刻见效的提示词。为什么是 Breakscale把架构图变成会呼吸的模拟系统大多数架构设计教程给你的是静态方框图和一句经验之谈加个缓存用个队列。但静态图画不出为什么 p99 延迟会在利用率过了 80% 后断崖式下跌也画不出一个短超时 两次重试如何把整个系统拖进重试风暴。Breakscale 的做法是把实验跑出来而不是描述它。你可以在画布上摆上负载均衡器、缓存、数据库、队列等33 种组件把它们连成一个系统再把流量滑块往上拖直到某个地方变红。它看到的不是一个看起来合理的数字而是一次真正的离散事件仿真延迟百分位爬坡、队列堆积、熔断器跳闸甚至整个系统塌进重试风暴——全部由一个个被模拟出来的真实请求测出来。上面这张就是最经典的Retry Storm重试风暴例子100 req/s 的流量下数据库几乎 100% 忙碌但有效吞吐是 0——因为重试把 100 个请求放大成了 348 个去砸一个本就满负荷的数据库。这正是用数字说话的价值。核心Breakscale MCP服务器的四个工具MCP 服务器本质上是把上面这套能力包装成 AI 能调用的工具。它对外暴露四个工具理解它们你就理解了这个 MCP 服务器能为你做什么工具它做什么read_me返回设计格式说明每种组件、每个参数、真实代码如何映射到组件create_view核心校验设计 → 仿真 30 秒 → 返回实测延迟/吞吐/失败数 一个 breakscale.tech 链接export_design把设计导出成.breakscale文件可在官网或 VS Code 扩展中打开open_design读回一个 breakscale.tech 分享链接方便你接着改它它的几个设计细节决定了AI 画架构图这件事真的好用33 种组件都认得。从service、db、cache、lb到ratelimiter、breaker、autoscaler、bulkhead等AI 写数据库负载均衡器都会被正确解析成对应的组件定义见 src/clipboard.ts。自动布局。你只管说谁调谁服务器会按请求流向从左到右自动摆放节点画出来的图和官网里的示例一样可读逻辑在 mcp/src/design.ts。错误会教AI。如果设计有错服务器不会只回一个报错而是点名是哪个节点/哪条边、哪里不对、以及你可能想写成什么让 AI 一次性改对而不是一遍遍试校验逻辑同样在 mcp/src/design.ts。数字都是测出来的。create_view会真正跑一次 30 秒的仿真引擎在 src/sim/engine.ts再用一段纯文本把结果讲给 AI系统级的 p50/p95/p99、吞吐、失败原因以及每个组件多忙、多少在排队、p99 多少、失败率多少见 mcp/src/run.ts。聊天框里还能开画布。在支持 MCP Apps 的客户端claude.ai、Claude Desktop、带 Copilot 的 VS Code、Cursor、Goose设计会直接在聊天里变成一个可运行的实时画布——你能点播放、拉流量、拖节点你在画布上的改动还会同步回 AI让它接着你看到的画面继续改。想一次性看全所有客户端的配置项目里有一份很全的指南mcp/README.md。两种接入方式远程托管 vs 本地运行Breakscale MCP 服务器有两种进入方式两者给你的是同样的四个工具远程托管服务器地址是https://mcp.breakscale.tech/mcp。无需安装、无需运行填上地址就能用而且它是 claude.ai 唯一支持的方式。本地运行用npx -y breakscale-mcp --stdio启动需要Node 20 及以上仿真会跑在你自己的电脑上。一句话建议先走托管零配置想要离线或自定义再切到本地。下面分别讲 Claude 和 Cursor 怎么接。接入 Claude一行命令或一个 Connector方式一Claude Code终端里的 Claude在终端执行一行命令把托管服务器加到你用户全局claude mcp add --transport http --scope user breakscale https://mcp.breakscale.tech/mcp--scope user表示在所有项目里都可用这正是读我的代码并变成设计所想要的。加完之后用/mcp检查是否连上想移除就claude mcp remove breakscale --scope user。如果想本地运行把它换成claude mcp add --scope user breakscale -- npx -y breakscale-mcp --stdio方式二claude.ai 网页版添加自定义 Connector进入Customize › Connectors › Add custom connector名字填Breakscale地址填https://mcp.breakscale.tech/mcp。它不需要登录所以 OAuth 相关字段留空即可。小提示Claude Code 属于只回数字 链接的客户端想要聊天框里的实时画布请用 claude.ai / Claude Desktop。接入 Cursormcp.json 两步搞定Cursor 的配置最简洁只放一个地址即可。所有项目通用写入~/.cursor/mcp.json单个项目写入.cursor/mcp.json{ mcpServers: { breakscale: { url: https://mcp.breakscale.tech/mcp } } }保存后Cursor 就能调用这四个工具了在支持 MCP Apps 的 Cursor 里create_view还会把实时画布直接嵌进对话。如果想改成本地运行把url换成下面这组即可breakscale: { type: stdio, command: npx, args: [-y, breakscale-mcp, --stdio] }AI读完代码画架构这些提示词一上手就能见效接入之后真正让它替你画架构的是怎么开口问。下面这几类覆盖了从画一张图到帮我找瓶颈的完整链路画个图→用 Breakscale 画一个速率限制器rate limiter的架构图。读我的代码→读一下这个仓库把它的架构变成 Breakscale 设计。哪些数字是你猜的请告诉我。找瓶颈→设计一个每秒扛 2000 请求的短链服务并告诉我它在哪里会先崩。加压→把流量翻倍。什么先挂不新增服务器的前提下你打算怎么修接着改→ 把一个 breakscale.tech 分享链接丢给它要求做某处修改它内部会用open_design读回设计。存档→把它保存成一个 .breakscale 文件。当 AI 读完你的代码、画出这样的多组件架构后你可以直接在聊天里的画布上拉流量、看指标哪个节点最先满、哪个 p99 先翘、失败都栽在哪个原因上——全部是仿真实测出来的而不是看起来合理。常见问题与排查连不上 //mcp里看不到确认地址是https://mcp.breakscale.tech/mcp且客户端确实加载了 MCP 配置本地模式需Node ≥ 20npx -y breakscale-mcp --stdio能单独跑起来。设计总是被拒这是好事——create_view会把所有问题一次列全并给出你可能想写成什么照着改一次通常就能过。格式不确定时先让 AI 调read_me看规范。想要文件而不是链接让 AI 调export_design拿到.breakscale文件在官网用Settings › Open a file或在 VS Code 扩展里运行Open Breakscale后打开即可。设计太大放不下链接服务器会自动提示改用export_design存成文件。入口在哪、两种模式怎么切见 mcp/src/main.ts带--stdio走标准输入给 AI 客户端自启不带则在/mcp提供 Streamable HTTP。小结Breakscale MCP 服务器把画架构 压测 找瓶颈这件事压缩成了三句话接上地址 → 让 AI 读代码或口述需求 → 拿到实测数字和可打开的链接。它给的不是漂亮图而是经得起追问的测量结果——同样的种子和拓扑可以确定性地重放数字对得上才值得你信。现在就可以打开终端或配置一个mcp.json让 Claude 或 Cursor 替你画出第一张会呼吸的架构图。赞分享【免费下载链接】breakscaleBuild a system, load it until it breaks, and watch why. A system design simulator for learning distributed systems.项目地址https://gitcode.com/gh_mirrors/br/breakscale点击查看免费下载相关推荐Joplin MCP 服务器接入指南让 Claude Desktop、Cursor 与 Zed 读写你的笔记库Joplin MCP 服务器接入指南让 Claude Desktop、Cursor 与 Zed 读写你的笔记库 本篇技术指南基于 Joplin 官方文档 re知识管理跨平台插件系统如何让 Cursor、Claude Code 等 MCP 客户端连接 Mem0 托管 MCP 服务器如何让 Cursor、Claude Code 等 MCP 客户端连接 Mem0 托管 MCP 服务器 AI 编码客户端Cursor、Claude Code 等人工智能AI AgentAgent 记忆RAGMeiGen AI Design MCP完全指南开源AI绘图MCP服务器如何一行命令接入Claude Code与CursorMeiGen AI Design MCP完全指南开源AI绘图MCP服务器如何一行命令接入Claude Code与Cursor MeiGen AI Design创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考