# Roast My Design System

> Roast My Design System is an open-source MCP server for design and media. Scans a UI repo for design-system gaps and serves on-system rules to coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://gregkozakiewicz.github.io/roast-my-design-system/
- **Repository:** https://github.com/gregkozakiewicz/roast-my-design-system
- **MCP Registry name:** io.github.gregkozakiewicz/roast-my-design-system
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

The premise comes from the author's own tests: an agent copies what it finds in a repo and invents where there is nothing to copy. The tool runs at the root of a UI repo with npx, opens a report within about a second and, per the README, needs no account, no network and no telemetry and changes nothing in the repo.

The report names where an agent will have to guess, lists the mess it would copy ranked by what fixing it is worth with file paths and a copy-ready fix prompt, and gives a 0 to 100 health score that is the same every run. One measured gap is charts that hardcode colours in a repo without a chart palette; the README says 43 of 126 public repos look like that.

The approach is described as roast, teach and guard: find the real design system, generate rules for agent files and a local MCP server that answers questions, then check every edit through a plugin hook. In the author's tests across 10 open-source products and 355 agent sessions, an agent called the MCP tools in only 7 of 24 Sonnet sessions and 2 of 24 Haiku sessions, while the edit hook ran without being asked and showed the lowest counts of off-system findings. The project's site has moved to roastds.com.

## Features

- **Design-system scan:** Finds the real design system in a repo, the mess in it and the gaps.
- **Guess map:** Shows where an agent will have to invent because the repo has no answer.
- **Health score:** A 0 to 100 score that is stable between runs.
- **Generated agent rules:** Writes rules into agent files so agents follow the system.
- **Local MCP answers:** Serves design-system answers to agents on request.
- **Edit guard:** A plugin hook checks every edit and can gate pull requests.

## Good for

- See where an AI agent is likely to invent UI in your codebase
- Rank design-system clean-up work by value
- Give a coding agent rules that match your tokens and components
- Check agent edits against the system automatically

## Install

### Claude Code (Terminal)

```sh
claude mcp add roast-my-design-system -- npx -y roast-my-design-system
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roast-my-design-system": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
```

## FAQ

### How do I run it?

Run npx roast-my-design-system@latest at the root of a UI repo.

### Does it send data anywhere?

The README says no account, no network and no telemetry, and nothing in your repo changes.

### Do agents call the MCP tools reliably?

Not always. In the author's October tests Sonnet called them in 7 of 24 sessions and Haiku in 2 of 24, which is why an edit hook is provided.

### What does the score mean?

A 0 to 100 health score for the repo's design system, the same on each run.

### Is Roast My Design System free?

Yes. Roast My Design System is open source, so you can use and self-host it for free.

### How do I add Roast My Design System to Claude Code?

Run this command in your terminal: claude mcp add roast-my-design-system -- npx -y roast-my-design-system

### What are the best alternatives to Roast My Design System?

The closest alternatives to Roast My Design System are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/roast-my-design-system
