# c2n Web Components

MCP-сервер c2n Web Components отдаёт ИИ-агенту точное API компонентов c2 (c2-*): атрибуты, слоты, события, CSS-переменные и примеры разметки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: code2nguyen
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/code2nguyen/web-components/tree/HEAD/packages/tools/mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/c2n-web-components

## Что делает

Сервер работает по stdio и подключается к любому MCP-хосту. Он раздаёт данные из локального `data/registry.json` — список компонентов, их API, галерею примеров, готовые пресеты, токены темы `@c2n/theme` и генерацию вариантов через отдельные инструменты (`list_components`, `get_component`, `get_theme`, `generate_variant` и другие). После установки обращения к реестру не требуют сети.

Отдельный инструмент `validate_markup` проверяет написанную разметку и CSS: находит нативные `<button>`, `<input>`, `<select>` и похожие элементы, которые заменяет компонент c2-*, неизвестные теги, атрибуты и CSS-переменные, а также box-стили (`border`, `padding`, `background`) на хосте c2-*. Эта же проверка доступна как CLI и как хук `PostToolUse` в Claude Code.

Сервер только сообщает факты об API компонентов c2 и не устанавливает пакеты и не редактирует код приложения сам — для этого используется отдельный пакет `@c2n/skill`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `C2N_PROJECT_ROOT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env C2N_PROJECT_ROOT=<C2N_PROJECT_ROOT> --transport stdio mcp -- npx -y @c2n/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp --env C2N_PROJECT_ROOT=<C2N_PROJECT_ROOT> -- npx -y @c2n/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@c2n/mcp"
            ],
            "env": {
                "C2N_PROJECT_ROOT": "<C2N_PROJECT_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@c2n/mcp"
            ],
            "env": {
                "C2N_PROJECT_ROOT": "<C2N_PROJECT_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e C2N_PROJECT_ROOT=<C2N_PROJECT_ROOT> mcp npx -y @c2n/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- получить точное API компонента c2-* без поиска по исходникам
- проверить вёрстку на неизвестные теги, атрибуты и CSS-переменные c2-*
- найти готовый пример оформления в галерее по описанию вроде «glass» или «pill»
- сгенерировать CSS-класс, Lit-подкласс или JSON из пресета темы
- подключить проверку разметки как хук PostToolUse в Claude Code

## Примеры запросов агенту
- Используй c2n MCP-сервер, чтобы показать полное API компонента `c2-button`
- Проверь файлы в `src` через `validate_markup` на неизвестные атрибуты c2-*
- Найди в галерее примеры оформления в стиле «pill» для компонентов c2

## Похожие
- [experience-lwc-base-components-integrate](https://affpapa.org/nevibecode/skills/experience-lwc-base-components-integrate.md) — скилл · 2800 установок
- [svelte-components](https://affpapa.org/nevibecode/skills/svelte-components.md) — скилл · 572 установки
- [KRDS Design System](https://affpapa.org/nevibecode/mcp/krds-design-system.md) — MCP-сервер · 531 установка
- [modern-web-guidance](https://affpapa.org/nevibecode/skills/modern-web-guidance.md) — скилл · 62500 установок
- [web-design-engineer](https://affpapa.org/nevibecode/skills/web-design-engineer.md) — скилл · 10200 установок
- [web-typography](https://affpapa.org/nevibecode/skills/web-typography.md) — скилл · 9900 установок

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