Skip to content
MCP server

Roast My Design System

Scans a UI repo for design-system gaps and serves on-system rules to coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
10.2.4
Listing updated
3 days ago

About Roast My Design System

Roast My Design System is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "roast-my-design-system": {
      "command": "npx",
      "args": [
        "-y",
        "roast-my-design-system"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Prices change. Check gregkozakiewicz.github.io before you buy.

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 to Roast My Design System

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory