breakscale-system-design-mcp-app.md

Breakscale System Design MCP App

MCP App · UI in chat

from"workersio"

2.0k

Breakscale is an open-source distributed-systems simulator. Its MCP server links tools to ui://breakscale/view.html, allowing a compatible host to display and edit the architecture canvas alongside measured simulation results.

Not for: Production load testing or capacity guarantees. Breakscale is a learning simulator; its simplified components and workloads do not replace tests against a real system.

Source and setup verified on 2026-11-03

Developer Tools

system designsimulationload testingarchitecture canvas

View on GitHub

Quick facts

Maintainer: workersio
UI evidence: ui://breakscale/view.html
Hosted endpoint: https://mcp.breakscale.tech/mcp
GitHub stars: 1,965 on 2026-11-03

What you can do

Draw distributed architectures
Apply simulated load
Inspect latency, throughput and failures
Edit and rerun the model from an embedded canvas

Requirements

An MCP Apps-compatible host
Node.js 20+ for local stdio use

setup.md

# 1. Add the hosted server to Claude Code

$claude mcp add --transport http --scope user breakscale https://mcp.breakscale.tech/mcp

# Local stdio

npx -y breakscale-mcp --stdio

The simulation runs on your machine in this mode and requires Node.js 20 or newer.

Always confirm the latest setup instructions with the maintainer before installing.

>Questions

Is Breakscale System Design MCP App an MCP App with inline UI?

Yes. The maintainer's source declares an MCP UI resource and links it to a tool result. It renders inline only in hosts that support MCP Apps.

Where were these details checked?

Against the maintainer's README, source, or official documentation at https://github.com/workersio/breakscale, plus the GitHub API where a repository is available.