# buoy

Показывает ИИ-агенту токены и правила вашей дизайн-системы. Находит захардкоженные цвета, случайные отступы и предлагает точную правку.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Автор: ahoybuoy
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ahoybuoy/buoy
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/buoy

## Что делает

Агент пишет `#3b82f6` там, где в проекте есть `var(--color-primary)`, и ставит `padding: 17px` при шкале кратностей 4. Buoy ловит такие расхождения и возвращает агенту подсказку вплоть до конкретной строки замены. Подключается как MCP-сервер, четыре инструмента: `list_design_tokens`, `find_token_for_value`, `check_ui_against_design_system`, `design_system_context`.

Начать можно без конфигурации. `npx ahoybuoy show all` печатает найденные компоненты, токены и дрейф, `npx ahoybuoy dock` добавляет `.buoy.yaml` и локальные интеграции. Файл `.buoy.yaml` описывает пути компонентов, токенов и владельцев — на нём строятся `buoy system map` и `buoy system impact`. Для Claude в комплекте идёт хук `PostToolUse`: проверяет каждый отредактированный файл стилей до того, как агент пойдёт дальше.

Без учётной записи работает локальный контур — сканы, правки, системная карта. Облачные функции вроде PR-бота на GitHub и синхронизации начинаются с `buoy ahoy login`. Ставить есть смысл до того, как накопится дрейф по всему репозиторию: `buoy rescue` умеет строить план, вносить правки в новую ветку и генерировать отчёт, но разбирать придётся уже накопленное.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add buoy -- npx -y @buoy-design/cli
```

### Codex

**Командой платформы**
```bash
codex mcp add buoy -- npx -y @buoy-design/cli
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "buoy": {
            "command": "npx",
            "args": [
                "-y",
                "@buoy-design/cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "buoy": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@buoy-design/cli"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add buoy npx -y @buoy-design/cli
```

## Когда брать
- найти захардкоженные цвета и заменить их на токены
- поймать произвольные отступы вне шкалы
- собрать карту дизайн-системы и непокрытой части UI
- оценить, кого затронет изменение компонента или токена
- прогнать проверку стилей перед коммитом

## Примеры запросов агенту
- Подключи buoy и проверь `src/components/Button.tsx` на захардкоженные цвета
- Найди токен для значения `#1a73e8` через buoy
- Сделай `buoy system impact Button` и покажи, кто использует компонент

## Похожие
- [Next AI Draw.io](https://affpapa.org/nevibecode/mcp/next-ai-drawio.md) — MCP-сервер · ★ 36398
- [tldraw](https://affpapa.org/nevibecode/mcp/tldraw.md) — MCP-сервер · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/nevibecode/mcp/figma-context-mcp.md) — MCP-сервер · ★ 16062
- [Agent-Native Assets](https://affpapa.org/nevibecode/mcp/agent-native-assets.md) — MCP-сервер · ★ 7506
- [Remove AI Watermarks](https://affpapa.org/nevibecode/mcp/remove-ai-watermarks.md) — MCP-сервер · ★ 6114
- [Dembrandt](https://affpapa.org/nevibecode/mcp/dembrandt.md) — MCP-сервер · ★ 3821

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md