MCP-Кукловод-Linux

Сервер Model Context Protocol, который обеспечивает возможности автоматизации браузера с помощью Puppeteer, с полной поддержкой серверов отображения Linux (X11 и Wayland). Этот сервер позволяет LLM взаимодействовать с веб-страницами, делать снимки экрана и выполнять JavaScript в реальной среде браузера.

Поддержка сервера отображения

Этот форк добавляет автоматическое обнаружение и настройку для серверов отображения Linux:

• Автоматическое обнаружение X11/Wayland

• Динамическая конфигурация переменных среды

• Поддержка различных сред рабочего стола (GNOME, KDE и т. д.)

• Механизмы отката и надежная обработка ошибок

• Совместимость с XWayland

Related MCP server: mcp-server-browserbase

Компоненты

Инструменты

• puppeteer_navigate

  • Перейдите по любому URL-адресу в браузере.

  • Ввод: url (строка)

• кукловод_скриншот

  • Делайте снимки экрана всей страницы или отдельных ее элементов.

  • Входные данные:

    • name (строка, обязательно): Имя для снимка экрана

    • selector (строка, необязательно): селектор CSS для элемента для скриншота

    • width (число, необязательно, по умолчанию: 800): ширина скриншота

    • height (число, необязательно, по умолчанию: 600): Высота скриншота

• puppeteer_click

  • Щелкните элементы на странице

  • Ввод: selector (строка): селектор CSS для элемента, на который нужно нажать

• puppeteer_hover

  • Элементы наведения на странице

  • Ввод: selector (строка): селектор CSS для элемента, на который наводится курсор

• puppeteer_fill

  • Заполните поля ввода

  • Входные данные:

    • selector (строка): CSS-селектор для поля ввода

    • value (строка): значение для заполнения

• кукловод_выбрать

  • Выберите элемент с помощью тега SELECT

  • Входные данные:

    • selector (строка): селектор CSS для выбираемого элемента

    • value (строка): значение для выбора

• puppeteer_evaluate

  • Выполнить JavaScript в консоли браузера

  • Ввод: script (строка): код JavaScript для выполнения

Ресурсы

Сервер предоставляет доступ к двум типам ресурсов:

1. Журналы консоли ( console://logs )

   • Вывод консоли браузера в текстовом формате

   • Включает все консольные сообщения из браузера

2. Скриншоты ( screenshot://<name> )

   • PNG-изображения сделанных снимков экрана

   • Доступно по имени снимка экрана, указанному во время захвата

Основные характеристики

• Автоматизация браузера с поддержкой сервера отображения Linux

• Автоматическое обнаружение и настройка X11/Wayland

• Мониторинг журнала консоли

• Возможности создания скриншотов

• выполнение JavaScript

• Базовое веб-взаимодействие (навигация, клики, заполнение форм)

Конфигурация

Конфигурация рабочего стола Клода

Установка

Установка через Smithery

Чтобы автоматически установить Puppeteer Linux для Claude Desktop через Smithery :

Ручная установка

1. Клонируйте репозиторий:

2. Установить зависимости:

3. Запустите сервер:

Показать сведения о сервере

Сервер автоматически определяет и настраивает соответствующую среду отображения:

Поддержка Уэйленда

• Обнаруживает сеансы Wayland через WAYLAND_DISPLAY

• Настраивает необходимые переменные среды:

  • WAYLAND_DISPLAY

  • QT_QPA_PLATFORM

  • GDK_BACKEND

  • MOZ_ENABLE_WAYLAND

  • XDG_SESSION_TYPE

Поддержка X11

• Откат для традиционных сеансов X11

• Обрабатывает переменные, специфичные для X11:

  • DISPLAY

  • XAUTHORITY

• Поддерживает различные среды рабочего стола и оконные менеджеры

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.