charlotte

charlotte — MCP-сервер сообщества (автор — ticktockbent). Рендер страниц в структурированное представление для агентов в безголовом Chromium. Ставится через Docker или через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ticktockbent
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Управляет headless Chromium, выполняет JavaScript на страницах, читает и ставит cookie, загружает и сохраняет файлы.

Настройка клиентов

vscode
{
    "code": "{\n  \"servers\": {\n    \"charlotte\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@ticktockbent/charlotte\"]\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Charlotte — MCP-сервер, который даёт ИИ-агентам структурированный и экономный по токенам доступ к вебу. Вместо того чтобы на каждом шаге выгружать всё дерево доступности страницы, Charlotte возвращает только нужное: краткую сводку при переходе на страницу, точечные запросы к конкретным элементам и полную детализацию лишь по явной просьбе. По замерам из README, главная страница Hacker News в Charlotte занимает 364 символа против примерно 50 000 у полного снимка Playwright MCP, а на тяжёлых страницах сводка меньше в 10–140 раз.

Сервер держит постоянную сессию headless Chromium и раскладывает каждую страницу на ориентиры, заголовки, интерактивные элементы с типами и координатами, формы и сводки содержимого. Инструменты по группам:

  • Навигация — navigate, back, forward, reload.
  • Наблюдение — observe с тремя уровнями детализации, find (поиск по смыслу, расположению и CSS-селекторам, с выгрузкой в файл), скриншоты с хранением артефактов.
  • Взаимодействие (с учётом iframe) — клики, клик по координатам, ввод текста, выбор, переключатели, отправка форм, прокрутка, наведение, перетаскивание, клавиши, ожидание условий, загрузка файлов.
  • Мониторинг — консоль и полная история HTTP-запросов.
  • Сессия — вкладки, эмуляция устройств вроде iPhone 15, ограничение сети и блокировка адресов, чтение, установка и очистка cookie.
  • Режим разработки — dev_serve (статический сервер с перезагрузкой), dev_inject (внедрение CSS и JS), dev_audit (доступность, производительность, SEO, контраст, битые ссылки).
  • Утилиты — evaluate выполняет произвольный JavaScript на странице.

Всего 43 инструмента. Профили запуска (core — 7, browse по умолчанию — 23, full — 43, а также interact, develop, audit) сокращают накладные расходы на описания инструментов до 75%; дополнительные группы включаются прямо в сессии через charlotte_tools.

Кому подойдёт

  • Разработчикам агентов, которым дорого обходится полное дерево доступности на каждом шаге.
  • Фронтенд-разработчикам: локальный сервер, внедрение стилей и аудит доступности и SEO.
  • Тестировщикам, которым нужно заполнять формы и проверять сценарии в браузере.

Похожие серверы — в категории браузер и парсинг.

Установка

Нужны Node.js 22.12 или новее и npm. Сервер ставится командой npm install -g @ticktockbent/charlotte и работает через stdio; профиль задаётся флагом, например charlotte --profile core. Есть Docker-образы на Docker Hub и GHCR (Alpine и Debian). Для удалённой работы с claude.ai есть режим Charlotte Remote: контейнер печатает публичный адрес коннектора и токен оператора; демонстрационные адрес и токен меняются при перезапуске.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "charlotte": {
      "type": "stdio",
      "command": "npx",
      "args": ["@ticktockbent/charlotte"],
      "env": {}
    }
  }
}

Для Claude Code создайте .mcp.json в корне проекта, для Claude Desktop добавьте блок в claude_desktop_config.json, для VS Code — в .vscode/mcp.json. Тот же JSON, что для Claude Desktop, подходит для .cursor/mcp.json в Cursor и ~/.codeium/windsurf/mcp_config.json в Windsurf.

Проверка

Попросите агента открыть главную страницу Hacker News и перечислить первые пять заголовков.

Примеры задач

Открой форму регистрации на тестовом стенде, заполни её и проверь, что появилось сообщение об успехе.
Запусти локальный сервер для папки dist и проведи аудит доступности и SEO.

Риски

  • Выполнение кода в браузере. evaluate выполняет произвольный JavaScript, а dev_inject внедряет CSS и JS в страницы.
  • Cookie и сессии. Инструменты читают и устанавливают cookie — фактически это доступ к сессиям на сайтах.
  • Файлы. upload отправляет локальные файлы на сайты, dev_serve раздаёт содержимое папки, скриншоты и результаты find сохраняются на диск.
  • Сеть. Браузер ходит на любые адреса, которые укажет агент.
  • Удалённый режим. Charlotte Remote публикует адрес коннектора; защищайте токен оператора и используйте свой домен и прокси для постоянной работы.

Частые вопросы

Чем Charlotte лучше Playwright MCP?

На тяжёлых страницах она возвращает в 10–140 раз меньше текста; на совсем маленьких страницах разница почти отсутствует.

Как уменьшить число инструментов?

Запустите с профилем core (7 инструментов) и включайте нужные группы через charlotte_tools.

Можно ли использовать Charlotte в claude.ai?

Да, через самостоятельно размещённый Charlotte Remote в Docker.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

browser-use

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники