better-design-mcp
v0.6.1
Published
MCP server for Better Design — design systems, UI principles, icons, and code review
Maintainers
Readme
better-design-mcp
Design systems, UI/UX principles, icons, and code review for AI coding agents. better-design.com
Setup
npx better-design-mcp setupDetects your MCP clients, writes the config (merge-safe, backed up), and adds an auto-invoke rule so your agent uses Better Design on UI work. Get an API key at better-design.com/mcp.
Claude Code:
claude mcp add --scope user better-design --transport http https://better-design.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Every other client: per-client config at better-design.com/mcp.
setup flags: --client <ids> (skip detection) · --project (vs default --global) · --api-key <key> · --no-rule (skip the CLAUDE.md/AGENTS.md rule) · --dry-run · --yes.
Supported clients: Claude Code, Cursor, VS Code (Copilot), Windsurf, Zed, Cline, Claude Desktop, OpenCode, Amp, Codex CLI, Continue.dev.
What you can ask
- "use better-design" → pick a system from the catalog; the agent installs it (tokens + every component) via shadcn.
- "create a design system that…" → generates a custom one and hands back a single
npx shadcn addcommand for your Next.js project. - Building any UI → it auto-loads design principles + WCAG/visual review rules so the output isn't generic AI slop.
Tools
| Tool | Description |
|------|-------------|
| resolve-design-system | Find systems by industry, personality, or style |
| get-design-system-docs | Install a full system (tokens + every component) via shadcn |
| preview-design-system | Render an inline visual preview of a catalog system |
| create-design-system | Generate a custom system; returns its project link |
| check-design-system-status | Poll a generation; returns the install command + preview when ready |
| get-ui-principle | UI principles (spacing, color, hierarchy, typography, depth…) |
| get-ux-principle | UX principles (forms, navigation, errors, onboarding…) |
| get-review-rules | WCAG 2.1 + visual design review checklists |
| resolve-icon-library · search-icons · install-icons · detect-icon-library | Find, search, and scaffold inline SVG icons |
After install, set
"style": "new-york"incomponents.jsonbefore running the shadcn command (the defaultbase-novastyle rewrites RadixasChildand breaks components). The returned install instructions include this.
