LumaBrowser MCP
Десктопный браузер с локальными моделями и встроенным MCP-сервером: Claude Code и Codex открывают вкладки и читают страницы.
- 140 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент управляет настоящим браузером с вашими вкладками, куками и входами в аккаунты.
- Режим управления рабочим столом на Windows дает агенту видеть и использовать другие приложения.
- REST API на порту 3000 без ключа доступен любому, кто достигает порта.
Установка
- Работает в
Ручная установка
npx lumabrowser startНужен Node 18 или новее; загружает и запускает последнюю сборку.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент управляет настоящим браузером с вашими вкладками, куками и входами в аккаунты.
- Режим управления рабочим столом на Windows дает агенту видеть и использовать другие приложения.
- REST API на порту 3000 без ключа доступен любому, кто достигает порта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
LumaBrowser — браузер на Chromium с локальными языковыми моделями на llama.cpp, генерацией изображений, голосом и собственными агентами. Для внешних агентов в нем есть MCP-сервер: Claude Code, Codex, Cline и OpenCode открывают вкладки, читают и извлекают данные страниц, вызывают агентов LumaBrowser, запускают таймерные задачи и следят за изменениями на странице. Запись в конфиг агента приложение делает из настроек. Кроме MCP доступны WebDriver и CDP для Selenium, Puppeteer и Playwright (по умолчанию выключены), консольный `luma` и плагины для VS Code и JetBrains. Для серверов есть образ Docker.
Для кого. Тем, кто хочет дать Claude Code или Codex настоящий браузер и держать модели и данные на своей машине.
Подходит, если
- Агенту нужно открыть страницу и прочитать ее в настоящем браузере.
- Тесты на Selenium или Playwright гоняют через CDP на локальном браузере.
- Страницу или элемент отслеживают и получают уведомление о смене.
- Локальная модель отвечает без отправки данных наружу.
Не подходит, если
- Достаточно библиотеки без окна браузера и без десктопного приложения.
- Порт 3000 нужно открыть в недоверенную сеть без ключа.
- Агенту нельзя видеть содержимое ваших вкладок.
Пример запроса к агенту
Открой в LumaBrowser страницу с ценами, извлеки таблицу и сообщи, когда значение в ней изменится.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
LUMA_API_PORT- Порт REST API LumaBrowser, по умолчанию 3000.
Ограничения
Нужно ставить целое десктопное приложение: Windows, Linux (AppImage) и macOS на Apple Silicon. Агент видит все, что видит браузер, и модель за ним тоже. REST API на порту 3000 по умолчанию без ключа: задайте ключ в настройках до выхода за пределы `localhost`. В Docker API принимает любые адреса и тоже без ключа. GitHub не определил лицензию репозитория, условия использования проверьте сами. Управление рабочим столом доступно только в Windows.
Как отключить. Удалите запись `luma-browser` из конфигурации агента и закройте приложение. Порты API, WebDriver и CDP в настройках оставьте выключенными.
Частые вопросы
Как подключить Claude Code?
Приложение само записывает MCP-запись в Claude Code, Cline, Codex и OpenCode из настроек. Вручную в конфиг добавляют `node` с путем к `mcp-server.js` из каталога установки.
Нужно ли держать приложение запущенным?
Нет. Сервер MCP запускает LumaBrowser, если тот не работает.
Открыт ли API в сеть?
По умолчанию нет, порты на `localhost`. REST API на порту 3000 работает без ключа, поэтому ключ нужно задать до любого внешнего доступа.
Можно ли использовать с Selenium или Playwright?
Да, через WebDriver или CDP. Оба режима выключены по умолчанию и включаются в настройках.
Есть ли версия для сервера?
Да. Образ Docker запускает приложение без окна и отдает рабочий стол через noVNC на порту 6080.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Browserless.io: облачный браузер для агента с чтением страниц, обходом сайтов, аудитом Lighthouse и сессиями с кликами
MCP-сервер внутри браузера Lilo для macOS на WebKit: Claude Code и Codex управляют настоящей вкладкой в отдельном пространстве.
Плагин для Claude Code с MCP-сервером и семью скиллами: агент управляет настоящим браузером, написав код на Python
Браузер для разработчиков на Chromium с локальным MCP-сервером: агент видит вкладки и консоль, делает скриншоты и кликает
Локальная платформа автоматизации браузера: MCP-сервер, CLI и скиллы, чтобы агент управлял Chrome, заполнял формы и доставал данные со страниц
Chromium с подменой отпечатка устройства на уровне движка и MCP-сервер, который дает агенту управлять им через Playwright
Коротко о README
Браузер, локальные модели, агенты и MCP-сервер собраны в одном приложении. Для автоматизации есть MCP, WebDriver, CDP, REST API и консольный `luma`.