gridcity
Your servers as a living city of light
Every server, database, bucket, load balancer and endpoint becomes a building whose light tells the truth about it. Monitor, manage, secure and fix them in one local app, with your AI agent over MCP.
- role
- Design & development
- type
- Local-first ops console · MCP server
- try it
- npx gridcity demo
- stack
- TypeScript · Fastify · React · three.js · Zod
- connects to
- SSH · PostgreSQL · MySQL · SQL Server · SQLite · MongoDB · Redis · S3 · AWS
- year
- 2026 · v0.4 · MIT
Why a city
Dashboards are walls of charts. You read them one by one and still miss the one box that is quietly dying. A city you read at a glance: a dark tower is offline, an amber one is over a threshold, a grey one has gone stale, a red ring means someone is attacking it.
Every kind of thing has its own shape, so you know what you are looking at before you read a label: drums are databases, hexagonal prisms are Redis, warehouses are buckets, gates are load balancers, beacons are probes.
What it does
The Doctor
Climbs DNS, port, TLS and login, and tries each candidate fix over a real read-only connection before it offers it. It says why: “stops at LOGIN: the server requires TLS.”
Time travel
Drag the timeline to see load, memory, disks and traffic at any past moment. Press play to replay an incident.
Root cause & blast radius
Builds a topology from declared, observed and load-balancer links, and names the one failure that explains the others.
Security on the map
SSH brute force and other attacks show as a red ring with a one-click block. CrowdSec and Fail2ban findings land on the same map.
Databases & buckets
Browse and query PostgreSQL, MySQL, SQL Server, SQLite, MongoDB, Redis and S3. Read-only until you allow changes, and every change is audited.
Alerts with the app closed
Browser push, email, Slack, Discord, Telegram, Teams, ntfy and more. It also warns ahead: expiring certificates, disks that will fill, late backups.
Your AI agent, with a human on the switch
GRIDCITY is also an MCP server, so Claude Code or any MCP client can work your infrastructure. Nothing runs behind your back.
- The agent asks for an incident_report or security_findings
- It calls diagnose and get_topology to find the cause
- It picks a fix from list_runbooks
- run_command asks for it: the app waits for your click
- You approve, it runs, the city shows the result
Try it in one line
Runs on your own machine with Node 22.12+. No cloud, no account, no telemetry; passwords and keys are stored encrypted on your disk.
npx gridcity demo
See it move
Built with
- Fastify server with WebSockets, Zod schemas shared with the client
- React 19, three.js via react-three-fiber, postprocessing for the glow
- xterm.js terminal over the existing SSH connection, CodeMirror for SQL
- pg, mysql2, mssql, better-sqlite3, mongodb, ioredis and the AWS SDK
- Official MCP server SDK for the agent tools
- Vitest and Playwright, shipped on npm and as a Docker image