MCP Puppeteer Linux Server

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

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

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

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

• Автоматическое обнаружение X11/Wayland
• Динамическая конфигурация переменных среды
• Поддержка различных сред рабочего стола (GNOME, KDE и т. д.)
• Механизмы отката и надежная обработка ошибок
• Совместимость с XWayland

Компоненты

Инструменты

• 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 в репозитории проекта.