Roast My Design System

Name: Roast My Design System
Author: gregkozakiewicz

作者：gregkozakiewiczバージョン 10.2.4i★ –iパソコンで動く

レジストリ名io.github.gregkozakiewicz/roast-my-design-system

インストール

概要

作者による説明（英語の原文）

Audit your Design System and serve your Agent the rules that keep AI-written UI on-system.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i初期↓ 369/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: デザイン・画像・音声

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
レジストリには、入力が必要なキーは載っていません。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

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

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント gregkozakiewicz で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

デザイン・画像・音声のほかのサーバーとの比較i

このカテゴリのほかの2795件のうち0%よりスターが多い
このカテゴリのほかの2795件のうち97%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2795件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Roast My Design Systemは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（10.2.4）がレジストリに届いたのは昨日です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Figma Context MCP, Claude Real Video, Figma MCP Server

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

作者：GLips広く使われている↓ 16.1万/週★ 1.6万5 か月前更新

パソコンで動く

インストール

Claude Real Video

Let any LLM watch a video locally — and search everything it has ever watched.

作者：HUANGCHIHHUNGLeo広く使われている↓ 1106/週★ 22842 か月前更新

パソコンで動く

インストール

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

作者：figma広く使われている★ 215213 か月前更新

クラウドで動く✓ mcp.figma.com

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

roast-my-design-system

Find where your AI agent will invent UI.

Your AI can write the UI. This makes sure it writes *your* UI.

npx roast-my-design-system@latest

Run it at the root of a UI repo. One second later, a report opens. No account. No network. No telemetry. Nothing in your repo changes.

Website, with the live example reports: www.roastds.com.

Version history is in CHANGELOG.md.

The idea

An agent copies what it finds.

It invents where the repo has no answer.

We tested this on 10 real open-source products, in 355 agent sessions, with and without this tool.

Findings each session added, counted by this tool's own rules:

Task	Model	When	Without roast	Roast MCP and rules installed	Roast plugin with its edit hook
A new chart and a new component, 4 products, 3 runs each	Sonnet 5	Oct 2026, roast 10.1	21 in 24 runs	not run	7 in 24 runs
A new chart and a new component, 4 products, 3 runs each	Haiku 4.5	Oct 2026, roast 10.1	72 in 24 runs	not run	1 in 24 runs
Add a panel, build a dashboard, tighten a list (80 sessions)	Sonnet 5	Sept 2026	7	9	not run
A Christmas theme, 10 products	Sonnet 5	Sept 2026	28	2	not run
A new chart, 4 products, 5 runs each	Sonnet 5	Sept 2026	10 in 20 runs	not run	0 in 20 runs
A new chart, 4 products	Haiku 4.5	Sept 2026	25	39	0 in 14 of 15 runs
Chart, status colour, empty state, new component	Haiku 4.5	Sept 2026	42 in 16 runs	49 in 16 runs	3 in 51 runs

Routine work stayed on-system with or without the tool. Work that needed something new did not.

An agent does not always call a tool when it should. In October, Sonnet called the MCP tools in 7 of 24 sessions and Haiku in 2 of 24. The edit hook runs without being asked. That is the column with the lowest numbers.

Where did the agent invent? Where the repo had nothing to copy. Dub has no chart palette. Its own charts hardcode 17 colours. Asked for a chart, Haiku hardcoded 9 more. In October, 5 of the 7 findings Sonnet left with the plugin on were chart colours on Dub. The agent kept them and wrote a comment saying the repo has no chart palette.

So the mess an agent adds is a map of the gaps in your system.

This tool draws the map.

Roast. Teach. Guard.

Roast the repo to find its real design system, the mess in it, and the gaps.

Teach the agent, through generated rules and a local MCP server.

Guard every edit, so the agent does not have to remember to ask.

ROAST what is in the repo, and what is missing ↓ TEACH rules in the agent files, answers over MCP ↓ GUARD every edit checked, the PR gated

What you get

Where will your agent have to guess?

The first thing the report says: the places where the repo has no answer yet, or "No gaps found".

the gap, in one line
the files that prove it
the one move that closes it

One gap is known for certain today, because the runs found it: charts hardcoding colours in a repo with no chart palette. 43 of 126 public repos look like that. A gap joins the list when it has been measured.

Fixes you can make right now to increase the health score

The mess the agent will copy, ranked by what fixing it is worth.

what was found
where, with the file path
why it matters
what to change
a copy button with the fix prompt for your agent

Fix, rescan, press the next button.

A score you can defend in a meeting

0 to 100. The same number every run.

Measured against three yardsticks: the ideal norms of a design system, the median of 34 product repos at the core of a 119-repo benchmark, and 10 reputable systems (Primer, Polaris, Carbon, shadcn/ui and others).

Monorepos get a score per package. packages/ui at 80 stops hiding apps/web at 40.

Every finding, with its file path

every hardcoded colour, and its near-identical twin
every spacing value off the scale
every duplicated component

And 8 more kinds, all in What it measures. One HTML file. Open it, Slack it, email it.

The colour usage bar shows where the repo's colour comes from: of every 100 colour uses, how many read a theme colour by name, how many use Tailwind's palette, and how many are strays written by hand. It follows CSS variables, Tailwind themes, Sass and Less variables and JavaScript theme objects to do the counting.

The header names what the repo is built on: shadcn/ui, a Tailwind theme, MUI, Mantine, Chakra or Ant Design, and both kits when a repo uses two.

Rules for your agent

Generated from your repo, into design-system-rules.md:

canonical components the file of colour, spacing and type values known duplicates to avoid spacing steps typefaces the kit's own vocabulary

--apply writes them into every agent file you have: Claude, Cursor, GitHub Copilot, Windsurf. Every scan also checks the rules you already have for stale references.

A script does the counting

Every number comes from a deterministic read of your files. Claude writes the explanation, labelled as written by AI and kept apart from the numbers.

How the runs were done

Claude Code, headless, on 10 public products pinned to one commit each: cal.com, Dub, Metabase, Plausible, SigNoz, trigger.dev and four more. 259 sessions in September 2026 and 96 in October 2026 on roast 10.1, with Sonnet 5 and Haiku 4.5. The October sessions repeat the chart and new-component tasks on Plausible, SigNoz, trigger.dev and Dub at the same commits. Every changed file was judged by this tool's rules at the end of the session and at the pinned commit. A finding counts only if the session added it.

Nothing was rendered. Zero findings means the code follows these rules. It does not mean the design was reviewed. Method, tables and limits are in the research write-up, which will be published separately.

Live examples

Eleven reports, hosted exactly as the tool writes them. Every number deterministic, every path real.

[npx shadcn create, fresh](https://www.roastds.com/examples/shadcn-create-fresh) (factory install, all 61 components): read as a fresh install, "the score is the kit's, not yours"; 13 colours, every theme variable in place, shadcn's own 24 bracket values named and not counted. No score.
[Unleash](https://www.roastds.com/examples/unleash-mui) (MUI): 1,109 files import the kit and the theme is read 6,166 times; 4 colours and 2 spacings per 100 kit files are written onto components. Score 60.
[Metabase](https://www.roastds.com/examples/metabase-mantine) (Mantine): its own wrapper over Mantine counts as the kit, so 2,679 files are read instead of 392; nothing written onto components, 2 spacings per 100 kit files. Score 47.
[SigNoz](https://www.roastds.com/examples/signoz-antd) (Ant Design): 2 colours and 7 spacings per 100 kit files written in style objects where a token exists. Score 51.
[Apache Airflow](https://www.roastds.com/examples/airflow-chakra) (Chakra UI): no colours written onto components, 4 spacings per 100 kit files as pixel strings where a space step exists. Score 43.
[vercel/ai-chatbot](https://www.roastds.com/examples/vercel-ai-chatbot) (shadcn install): 71 values like [13px] written outside the Tailwind scale, and 66 palette colours per 100 files where a theme variable exists; Claude's notes embedded. Score 80.
[excalidraw/excalidraw](https://www.roastds.com/examples/excalidraw-excalidraw): 78 off-scale spacing values and 90 !important declarations. Score 55.
[dubinc/dub](https://www.roastds.com/examples/dubinc-dub): 642 arbitrary bracket values, 21 duplicated components, and the chart-palette gap named. Score 20.
[telekom/scale](https://www.roastds.com/examples/telekom-scale) (Stencil): 95 Stencil components read by tag; 66 spacing values outside the scale where about 12 would do; Claude's notes embedded. Score 55.
[magicuidesign/magicui](https://www.roastds.com/examples/magicui) (registry): counted on the components it publishes, 52 off-theme colours per 100 files in the code it ships, its docs site kept out and named. Score 78.
[adobe/spectrum-web-components](https://www.roastds.com/examples/adobe-spectrum) (Lit): 740 colour tokens with 8 hardcoded colours beside them, and 37 !important declarations. Score 83.

The full report for vercel/ai-chatbot. The verdict answers what the agent will learn here, the gap section comes first, then "What the repo teaches the agent", Claude's read of the scan:

The same report in light mode (one file, built-in toggle):

Why the numbers hold

Deterministic. A zero-dependency Node script reads every file and returns the same numbers every run. About a second on a normal repo.
Read-only. No network. No telemetry. The test suite fails if package.json ever declares a dependency. Every release runs 468 checks against 29 sample repos before it is tagged; the fixtures and their snapshots live in tests/, one JSON file each.
Honest gaps. What the scan cannot read says "not measured" and drops out of the score.
Honest exclusions. Tests, stories, docs sites, artwork and email templates are left out. Your own exclusions are printed in the report header with file counts.
A real benchmark. 119 public repos. A core fleet of 34 React repos sets the medians; the rest feed the kit and web-component groups, so a shadcn repo is compared with shadcn repos and a Lit system with Lit and Stencil systems. The builder is in tools/benchmark/.
Importable scoring. scoreHarvest(harvest) returns the score and metrics as plain data. The report and a CI check get the same numbers.

The long version, with scan scoping and what the plugin runs on your machine, is in docs/reference.md.

Works with

Frameworks

React, Next.js, Remix, Vite Stencil, Lit, custom elements

Kits and styling

Tailwind, sha

冒頭だけを表示しています。続きはリポジトリで読めます

Roast My Design System

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

デザイン・画像・音声のほかのサーバーとの比較i

よくある質問

代わりの候補

Figma Context MCP

Claude Real Video

Figma MCP Server

作者のREADME

roast-my-design-system

Find where your AI agent will invent UI.

The idea

An agent copies what it finds.

It invents where the repo has no answer.

Roast. Teach. Guard.

What you get

Where will your agent have to guess?

Fixes you can make right now to increase the health score

A score you can defend in a meeting

Every finding, with its file path

Rules for your agent

A script does the counting

How the runs were done

Live examples

Why the numbers hold

Works with

Frameworks

Kits and styling