Puppeteer·merajmehrabi

Puppeteer MCP — подключение и инструкция

Puppeteer MCP предоставляет агенту browser automation: навигацию, чтение страниц и действия в тестовом браузере.

БраузерЛокальноБез ключа

Что умеет этот сервер

01

Puppeteer MCP предоставляет агенту browser automation: навигацию, чтение страниц и действия в тестовом браузере.

02

Экспериментальная community-реализация может запускать новый браузер или подключаться к существующему Chrome через debugging.

03

Открой тестовую страницу, прочитай состояние, выполни одно действие и заново проверь результат.

Задача для знакомства

Через Puppeteer MCP открой тестовую страницу и прочитай заголовки. Формы, покупки и сообщения не отправляй.

Уточнить результат

Сверь browser instance, URL и актуальные selectors. После изменения DOM не повторяй старый клик без чтения нового состояния.

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

Выберите подходящий способ

Подключить Puppeteer MCP

Добавь npx -y puppeteer-mcp-server. Для обычного режима сервер создаёт новый браузер; active tab подключай отдельно через соответствующий tool и локальный debugging-порт.

Что понадобится

  • Node.js/npm и совместимый браузер. Для active-tab режима нужен отдельный профиль с remote debugging.
  1. 01

    Подготовь окружение

    Node.js/npm и совместимый браузер. Для active-tab режима нужен отдельный профиль с remote debugging.

  2. 02

    Установи и настрой

    Добавь npx -y puppeteer-mcp-server. Для обычного режима сервер создаёт новый браузер; active tab подключай отдельно через соответствующий tool и локальный debugging-порт.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

{
  "mcpServers": {
    "puppeteer": {
      "command": "puppeteer-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Первый запрос — пример для чата агента

Через Puppeteer MCP открой тестовую страницу и прочитай заголовки. Формы, покупки и сообщения не отправляй.

Как проверить

Сверь browser instance, URL и актуальные selectors. После изменения DOM не повторяй старый клик без чтения нового состояния.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Puppeteer

Puppeteer MCP предоставляет агенту browser automation: навигацию, чтение страниц и действия в тестовом браузере.

Экспериментальная community-реализация может запускать новый браузер или подключаться к существующему Chrome через debugging. Это не тот же архивный reference server.

Что подготовить перед подключением

Node.js/npm и совместимый браузер. Для active-tab режима нужен отдельный профиль с remote debugging.

Как установить и подключить

Добавь npx -y puppeteer-mcp-server. Для обычного режима сервер создаёт новый браузер; active tab подключай отдельно через соответствующий tool и локальный debugging-порт.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Открой тестовую страницу, прочитай состояние, выполни одно действие и заново проверь результат. Сохраняй screenshot при расхождении ожидаемого и фактического интерфейса.

Как проверить результат и решить проблемы

Сверь browser instance, URL и актуальные selectors. После изменения DOM не повторяй старый клик без чтения нового состояния.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Подключённый Chrome может содержать активные аккаунты. Не публикуй debugging-порт в сеть и не используй отправку форм как тест соединения.

Исходники и документация

Репозиторий: merajmehrabi/puppeteer-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Puppeteer

Puppeteer MCP предоставляет агенту browser automation: навигацию, чтение страниц и действия в тестовом браузере.
Вернуться в библиотеку