charlotte

charlotte

TickTockBentMIT
144 звёзд20 форков
Charlotte — это MCP-сервер, который превращает веб-страницы в структурированные данные для AI-агентов. Вместо того чтобы выгружать всё дерево доступности (десятки или сотни тысяч символов), он разбивает страницу на логические блоки: заголовки, регионы, формы и интерактивные элементы. Когда агент впервые переходит на страницу, Charlotte отдаёт компактную ориентировку — всего несколько сотен символов. Если агенту нужны подробности, он запрашивает конкретные элементы точечными запросами. Такой подход снижает расход токенов в 25–182 раза по сравнению с Playwright MCP. Для продакшн-нагрузок это экономит тысячи долларов на API. Сервер работает локально на базе Chromium в headless-режиме и не требует облачной инфраструктуры.
ChromeBrowser
Открыть на GitHub

Установка

npx -y @ticktockbent/charlotte

Характеристики

Общее

  • СтатусСообщество
  • РазработчикTickTockBent
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Загружает веб-страницы в headless-браузере на движке Chromium и формирует типизированное представление DOM.
  • При навигации возвращает компактную сводку: основные landmark-регионы, заголовки, количество ссылок и интерактивных элементов.
  • Ищет элементы точечно: все кнопки, ссылки, поля ввода с заданными атрибутами.
  • Работает на трёх уровнях детализации ответа — от поверхностного обзора до полного содержимого элемента.
  • Есть профили инструментов: browse (23 инструмента, по умолчанию), core (7 инструментов), full (43 инструмента).
  • Снижает overhead на определении инструментов на каждом вызове API до 78%.
  • Экономит токены на реальных страницах: Hacker News занимает 336 символов вместо 61 230, Википедия — 7 667 вместо 1 040 636.
  • Устанавливается одной командой через npx без дополнительных зависимостей.

Как подключить

Установка выполняется одной командой через Node.js:

npx -y @ticktockbent/charlotte

Добавьте сервер в конфигурацию вашего MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "charlotte": { "command": "npx", "args": ["-y", "@ticktockbent/charlotte"] } } }

После добавления перезапустите клиент.

Примеры запросов

  • «Открой главную Hacker News и покажи 10 самых новых постов с заголовками и ссылками».
  • «Найди на этой странице все внешние ссылки и выведи их списком».
  • «Возьми текст статьи из указанного региона, сохрани его в файл».
  • «Сделай обзор репозитория Charlotte на GitHub: какие секции есть в README?»
  • «Найди на странице форму логина и заполни поля логина и пароля, если они есть».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: TickTockBent
  • Совместимость: Claude Desktop, Cline, Goose и любые другие MCP-клиенты.

Поделиться