# charlotte

MCP-сервер charlotte отдаёт агенту компактную структуру страницы вместо полного accessibility-дерева. Полезно, когда агент часто ходит в браузер и жжёт токены на мусоре.

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

## Что делает

Charlotte держит постоянный headless Chromium и переводит страницу в типизированное представление: landmarks, заголовки, интерактивные элементы, формы, краткие описания контента. Вместо дампа accessibility-дерева на каждый вызов агент получает три уровня детализации.

При переходе на новую страницу `navigate` возвращает компактную ориентацию. Для Hacker News это 364 символа против примерно 50 000 у полного снапшота Playwright MCP. Когда нужно больше, агент зовёт `observe` или `find` и платит только за то, что запросил.

Инструментов 43, но все сразу грузить не обязательно: профили `browse` и `core` режут накладные расходы на определения инструментов. Дефолтный `browse` несёт примерно на 49% меньше оверхеда, чем полный набор.

Среди возможностей — навигация, наблюдение, iframe-взаимодействие, мониторинг консоли и запросов, управление вкладками, эмуляция устройств, троттлинг сети, `dev_serve` со статическим сервером и авто-перезагрузкой, `dev_audit` для проверки a11y, производительности, SEO, контраста и битых ссылок. Для работы нужен Node.js: сервер запускается через `npx`.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- сократить расход токенов при чтении страниц агентом
- получить структуру страницы без полного accessibility-дерева
- найти конкретный элемент через `find` вместо чтения всего снапшота
- снять скриншот и сравнить структуру со снапшотом
- проверить страницу на a11y, SEO и битые ссылки

## Примеры запросов агенту
- Открой Hacker News и покажи заголовки первых пяти постов
- Найди на странице кнопку входа через `find` и кликни по ней
- Заполни форму на этой странице данными из `data.json`

## Похожие
- [oculo](https://affpapa.org/nevibecode/mcp/oculo.md) — MCP-сервер · ★ 5 у репозитория
- [fortress](https://affpapa.org/nevibecode/mcp/fortress.md) — MCP-сервер · ★ 818 у репозитория
- [PageMap](https://affpapa.org/nevibecode/mcp/pagemap.md) — MCP-сервер · ★ 36 у репозитория
- [Kernel MCP Server](https://affpapa.org/nevibecode/mcp/kernel-mcp-server.md) — MCP-сервер · ★ 40 у репозитория
- [mcp](https://affpapa.org/nevibecode/mcp/kitewright-mcp.md) — MCP-сервер · ★ 24 у репозитория
- [CloakMCP](https://affpapa.org/nevibecode/mcp/cloakmcp.md) — MCP-сервер · ★ 14 у репозитория

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