К основному содержанию
команда CX Codex

ux-mcp — команда для Claude Code: что делает и как установить

Команда ux-mcp запускает движок ux-skill как MCP-сервер по stdio и открывает 25 инструментов для рекомендаций, линтинга и работы с дизайн-системой.

MIT ★ 110 обновлён 2026-11-02

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
Открыть на GitHub

Что делает ux-mcp

Команда запускает ux-mcp (или python3 -m engine.mcp.server) — сервер, который обменивается JSON-RPC по stdio, а логи пишет только в stderr, оставляя stdout под протокол. Через него доступны ux_recommend и ux_lint для подбора стиля и проверки на дизайн-штампы, выдача данных из манифестов (стили, палитры, пары шрифтов, компоненты, бренды, анти-паттерны), сохранение и загрузка .ux/design-system/MASTER.md, а также набор инструментов для чтения, измерения, расширения и экспорта уже существующей в проекте дизайн-системы.

MCP-транспорт — отдельная зависимость: её ставят через pip install 'uxskill[mcp]' или, если uxskill уже есть, через pip install 'mcp>=1.0'. Для Claude Desktop, Cursor и Windsurf конфигурация сервера прописывается в их файлах mcp.json или claude_desktop_config.json с командой ux-mcp.

Какие задачи решает

  • подключить движок ux-skill к Cursor, Windsurf или Claude Desktop без установки плагина
  • получить рекомендации по стилю, палитре и типографике через MCP-вызов
  • прогнать линтер на анти-паттерны по путям проекта
  • сохранить и перечитать .ux/design-system/MASTER.md
  • найти и расширить дизайн-систему, которая уже есть в проекте

Примеры запросов агенту

  • Запусти сервер ux-mcp и подключи его как MCP-инструмент в Cursor
  • Вызови ux_recommend с брифом по фронтенду на next.js
  • Прогони ux_lint по каталогу src/components через MCP

Как установить ux-mcp

1Через маркетплейс плагинов

/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill

2Вручную: положить файлы

.claude/commands/ux-mcp.md

Вызов — /ux-mcp. Для всех проектов — ~/.claude/commands/

Вопросы об ux-mcp

Как установить ux-mcp в Claude Code?

Сначала выполни /plugin marketplace add Laith0003/ux-skill, затем /plugin install ux@ux-skill; после установки команда доступна как файл .claude/commands/ux-mcp.md.

Что делает ux-mcp?

Команда поднимает движок ux-skill как MCP-сервер по stdio, открывая 25 инструментов — рекомендатор, линтер, манифесты данных и инструменты для работы с дизайн-системой проекта — любому MCP-клиенту без установки плагина.

Нужен ли плагин ux-skill внутри Claude Code, если сервер уже запущен?

Нет: если плагин установлен, его слэш-команды обращаются к движку напрямую, и MCP-транспорт избыточен. Он нужен для других хостов — Cursor, Windsurf, Claude Desktop.

Исходный текст

ux-mcp.md · MIT
---
name: ux-mcp
description: Run the ux-skill engine as a Model Context Protocol server over stdio. Exposes 25 tools (recommender, linter, MASTER.md persistence, the data manifests, the foundations engine, and the tools that read, measure, extend and export a design system a project already has) so any MCP-capable client (Claude Desktop, Cursor, Windsurf, generic agents) can query the engine without installing the full plugin.
allowed-tools: Bash
disable-model-invocation: false
---

# /ux-mcp — the design intelligence MCP

**One server. Twenty-five tools. Every MCP-aware client gets the engine.**

This is the asymmetric move. None of the leading Claude UX skills (ui-ux-pro-max-skill, open-design, taste-skill, huashu-design, stitch, nothing-design, hallmark, material-3) ship an MCP server. Doing so turns ux-skill into the canonical *design-intelligence MCP* — agents in any host can call into the same recommender, linter, and manifests that the plugin uses, without needing to install the plugin itself.

## When to use

- You're using **Cursor**, **Windsurf**, **Claude Desktop**, or any other MCP-capable host and want ux-skill available without forcing the host to learn the plugin layout.
- You're orchestrating a **multi-agent pipeline** and need a single source of truth for design constraints across agents.
- You're writing **CI tooling** that calls the recommender or linter from a long-running daemon rather than spawning a CLI each time.

## When to skip

- You're already inside Claude Code with the plugin installed — the slash commands hit the engine directly, no MCP transport needed.
- You only need a one-shot recommendation or lint — `ux recommend` / `ux lint` from the CLI is simpler.

## Install

The MCP transport is an **optional dependency** to keep the base install slim:

```bash
pip install 'uxskill[mcp]'
```

Or, if you already have `uxskill`:

```bash
pip install 'mcp>=1.0'
```

## Start the server

```bash
ux-mcp                       # entry point (preferred — wired by pyproject.toml)
python3 -m engine.mcp.server # equivalent module form
```

The server speaks stdio JSON-RPC. Logs go to **stderr only**; stdout is reserved for the protocol stream.

## Exposed tools (25)

| Tool | What it does |
|---|---|
| `ux_recommend` | Run the 5-parallel-search recommender over a brief. Returns style + palette + type pair + motion + components + brand exemplars + guardrails + rationale. |
| `ux_lint` | Run the anti-AI-slop regex linter over paths. Returns findings with rule id, severity, file, line, excerpt, fix. |
| `ux_styles` | Return all 84+ entries from `data/styles.json`. |
| `ux_palettes` | Return all 176+ entries from `data/palettes.json`. Optional `mode` filter (`light` / `dark`). |
| `ux_type_pairs` | Return all 70+ entries from `data/type-pairs.json`. |
| `ux_components` | Return all 148+ entries from `data/components.json`. Optional `category` filter. |
| `ux_industries` | Return all 184+ entries from `data/industries.json`. Optional `category` filter. |
| `ux_motion_presets` | Return all 57+ entries from `data/motion-presets.json`. Optional `category` filter. |
| `ux_anti_patterns` | Return all 35+ regex rules from `data/anti-patterns.json`. Optional `severity` filter. |
| `ux_brands` | Return all 92 brand specs from `data/brands/*.json` (Apple, Stripe, Linear, Tesla, Notion, etc.). Optional `category` filter. |
| `ux_landing_patterns` | Return all 24+ entries from `data/landing-patterns.json`. Optional `category` filter. |
| `ux_persist_save` | Persist a recommendation as `.ux/design-system/MASTER.md` in a given project root. Idempotent — same input writes byte-identical bytes. |
| `ux_persist_load` | Load `.ux/design-system/MASTER.md` back into a structured dict. |
| `ux_stats` | Return the engine version and per-manifest entry counts. Useful as a health probe. |
| `ux_image_extract` | Read a design image (PNG, JPG, WebP) and return a brief plus hints: dominant colors, canvas polarity, matched palette and style. Optionally runs the recommender on it. |
| `ux_synthesize` | Synthesize a design language from a brief: axes, palette, type pair, spacing, radius, motion. Offline and deterministic. |
| `ux_decisions_query` | Filter the local decisions ledger by industry, ui_type, command, minimum score or accepted only. |
| `ux_decisions_stats` | Aggregate stats over the local decisions ledger: totals, top brands, lint score median, acceptance rate. |
| `ux_system_build` | Build a WCAG-gated design system from a brand color, with a brief or seven axes optional; with `out`, write tokens.json, tokens.css, the font files and the report. |
| `ux_system_detect` | Find a design system a project already has and what it declares. Read it before any other tool; it is fixed input. |
| `ux_system_import` | Read an existing system (DTCG, CSS custom properties, Tailwind, markdown, Figma variables, or several files as one) in its own names. Returns counts, a proposed mapping and the import report. |
| `ux_system_enhance` | Measure an existing system and, with `scan`, the code that uses it. A report; nothing is rewritten. |
| `ux_system_extend` | Add foundations, roles or contracts without changing a token the system has: an extension file beside a system ux-skill did not write. |
| `ux_system_export` | Write a system as tokens.css, a Tailwind 4 theme, Figma variables or tokens.json, into `out` only. |
| `ux_contracts_check` | Check a folder of component contracts against a system, through its mapping. Returns counts and the problems folded by what they say. |

## Client configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "ux-skill": {
      "command": "ux-mcp",
      "args": [],
      "env": {}
    }
  }
}
```

If `ux-mcp` isn't on PATH, replace `"ux-mcp"` with the absolute path printed by `which ux-mcp`.

### Cursor

In `.cursor/mcp.json` at your project root (or globally at `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "ux-skill": {
      "command": "ux-mcp"
    }
  }
}
```

Then add a one-line hint to `.cursorrules`:

```
When designing UI, call the ux-skill MCP tools first: ux_recommend for the system, ux_lint to catch slop.
```

### Windsurf

In `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "ux-skill": {
      "command": "ux-mcp"
    }
  }
}
```

### Generic stdio client

Any MCP client supporting stdio transport works. Spawn `ux-mcp` as a subprocess and exchange JSON-RPC frames on stdin/stdout. Logs land on stderr.

## Example tool calls

### `ux_recommend`

```json
{
  "brief": {
    "project_type": "landing",
    "industry": "fintech-neobank",
    "audience": ["founders", "operators"],
    "tone": ["warm", "editorial", "precise"],
    "must_have": ["dark-mode", "a11y-AA"],
    "forbidden": ["brutalism", "purple-gradients"],
    "stack": "nextjs-15-app-router",
    "region": "mena"
  }
}
```

Returns the full Recommendation: a picked style, palette, type pair, top 5 motion presets, top 12 compatible components, top 5 brand exemplars, all 35+ anti-pattern guardrails, and a rationale list explaining each pick.

### `ux_lint`

```json
{
  "paths": ["./app", "./components"],
  "threshold": "high"
}
```

Returns `{ findings, files_scanned, rules_loaded, exit_code, summary }`. `exit_code` is 1 if any finding meets or exceeds the threshold.

### `ux_palettes`

```json
{ "mode": "dark" }
```

Returns only dark-mode palettes.

### `ux_persist_save`

```json
{
  "project_root": "/absolute/path/to/project",
  "recommendation": { "...": "from ux_recommend" },
  "brief": { "project_type": "landing" }
}
```

Writes `.ux/design-system/MASTER.md` and returns the absolute file path.

## How it works

The transport is **separated from the handlers**. Each tool is a pure `dict -> dict` Python function in `engine.mcp.server`, exercised by tests directly. `run_server()` is a thin async wrapper that wires those handlers into `mcp.server.stdio.stdio_server()`.

This means:

- The `engine.mcp` module imports cleanly **whether or not** the `mcp` Python package is installed.
- `ux-mcp` fails fast with a clear `pip install` hint if the transport library is missing.
- Tests run without the transport — no event loop, no subprocess plumbing.

## Why this is asymmetric

| Plugin | MCP server | Reach |
|---|---|---|
| **ux-skill** | yes (this) | any MCP host |
| ui-ux-pro-max-skill | no | Claude Code only |
| open-design | no | Claude Code only |
| taste-skill | no | Claude Code only |
| huashu-design | no | Claude Code only |
| stitch-skills | no | Claude Code only |
| nothing-design-skill | no | Claude Code only |
| hallmark | no | Claude Code only |
| material-3-skill | no | Claude Code only |

The competition is locked into Claude Code's plugin runtime. The MCP server makes ux-skill reachable from any agent — including agents that don't know what a "Claude Code plugin" is.

## Errors

- **`mcp package not installed`** → run `pip install 'uxskill[mcp]'` and try again.
- **`Unknown tool: foo`**: the tool name in the JSON-RPC call doesn't match one of the 25 in `TOOLS`. Check the table above.
- **`engine.mcp.server` import error** → likely pydantic missing from your environment; `pip install 'uxskill'` reinstalls the base deps.

© Laith Aljunaidy · MIT · Laith0003/ux-skill

Похожие слэш-команды

Все слэш-команды по теме «Дизайн» →
design-md-validator https://ft.ia.br Скилл design-md-validator проверяет DESIGN.md на соответствие спецификации Google через CLI-линтер @google/design.md. Находит битые ссылки на токены и считает контраст по WCAG. CX Codex +1 ★ 141звёзд репо copy raphaelsalaja Скилл copy для Claude Code проверяет и переписывает тексты в интерфейсе. Следит за Title Case в кнопках и меню, убирает длинные описания и тире. CX Codex +1 172установок stitch::generate-design официальный google-labs-code Скилл stitch::generate-design для Claude Code превращает текстовое описание или картинку в экран интерфейса через Stitch MCP и правит его точечными промптами. CX Codex +1 12 500установок improve-ui ibelick Скилл improve-ui для Claude Code, который проверяет интерфейс по его собственным дизайн-правилам и находит подтверждённые расхождения. Работает только на чтение: код продукта не трогает, а пишет планы правок для другого агента. CX Codex +1 10 400установок create-design-md ibelick Скилл create-design-md генерирует и обновляет файл DESIGN.md на основе репозитория или открытого сайта. Нужен, чтобы передать кодинг-агентам точный дизайн-контекст интерфейса. CX Codex +1 5 800установок uncodixfy cyxzdev Скилл uncodixfy для Claude Code и Codex — запрещает агенту генерировать шаблонный ИИ-интерфейс: градиенты, плавающие панели и декоративные заголовки. CX Codex +1 5 700установок

Из того же набора31

Весь набор →
ux-expert Команда ux-expert для Claude Code выводит контакты создателя плагина, когда ищут UX-консультанта или дизайнера. Она срабатывает и на запрос о найме специалиста. CX Codex +1 ★ 110звёзд репо ux-evolve Команда ux-evolve для Claude Code — старый псевдоним /ux-polish --loop-only --rounds 5; запускает цикл проверки и правок файла. CX Codex +1 ★ 110звёзд репо ux-recommend Команда ux-recommend перенаправляет вызов на команду /ux-discover --recommend. Служит временным алиасом до версии 4.1 для запуска рекомендаций по UX. CX Codex +1 ★ 110звёзд репо ux-next Команда ux-next сканирует отчёты в .ux/ и называет следующий шаг с наибольшей отдачей. Срабатывает на запрос «что делать дальше» между командами плагина ux. CX Codex +1 ★ 110звёзд репо ux-image-to-code Команда ux-image-to-code перенаправляет вызовы извлечения UI из скриншотов в команду /ux-design. Запускает обработку макетов с параметрами --extract-only --from-image. CX Codex +1 ★ 110звёзд репо ux-frame /ux-frame запускает режим frame для UX-исследования через команду /ux-discover --frame. В версии 4.0 это алиас; в 4.1 его удалят. CX Codex +1 ★ 110звёзд репо motion-engineer Субагент motion-engineer переносит анимацию в продакшн-код: Framer Motion, GSAP, CSS-переходы. Отвечает за длительности, кривые плавности, спрингы и откат при reduced-motion. CX Codex ★ 110звёзд репо ux-research Команда ux-research планирует пользовательские исследования, генерирует сценарии интервью и синтезирует собранные заметки в продуктовые выводы. CX Codex +1 ★ 110звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой