JP

jaenster/puppeteer-mcp-claude

Browser automation

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

49 stars 5 forks Качество 64 Тренд 17MIT

Сервер MCP для автоматизации браузера Claude, работающий на Puppeteer.

Обзор

Сервер Model Context Protocol, который предоставляет Claude Code (и любому другому клиенту, знающему MCP) реальный браузер через Puppeteer - перемещаться по страницам, нажимать и вводить, запускать JavaScript, захватывать скриншоты, управлять файлами cookie, перехватывать запросы. Node.js ≥ 18 - клиент с поддержкой MCP (Claude Code, Claude Desktop, Cursor, Codex CLI, ...) - Chromium загружается автоматически Puppeteer при первой установке (~ 170 МБ) Оба скрипта проверяют Node ≥ 18, устанавливают пакет глобально через npm и регистрируют его с помощью кода Claude в поле пользователя. Переопределить область действия с помощью SCOPE = project (bash) или $env:SCOPE = 'project' (PowerShell). Если вы предпочитаете не запускать удаленный сценарий: Затем перезагрузите код Клода и спросите: «Снимок экрана example.com». Вам не нужно сначала вызывать puppeteer launch — браузер автоматически запускается по умолчанию, когда запускается любой другой инструмент. Page ids по умолчанию «по умолчанию», поэтому потоки одиночных вкладок могут полностью опустить PageId. Каждый инструмент возвращает свой результат в двух параллельных формах: Содержание[0].

Обзор (машинный перевод)

Сервер Model Context Protocol, который предоставляет Claude Code (и любому другому клиенту, знающему MCP) реальный браузер через Puppeteer - перемещаться по страницам, нажимать и вводить, запускать JavaScript, захватывать скриншоты, управлять файлами cookie, перехватывать запросы.

Требования

  • Node.js ≥ 18 MCP-клиент (Claude Code, Claude Desktop, Cursor, Codex CLI, …) Chromium загружается автоматически Puppeteer при первой установке (~ 170 МБ)

##Установка

macOS/Linux

Окна (PowerShell)

Оба скрипта проверяют Node ≥ 18, устанавливают пакет глобально через npm и регистрируют его с помощью кода Claude в поле пользователя. Сверхнормативная область с SCOPE=project (баш) или $env:SCOPE='project' (PowerShell).

Manual — если вы предпочитаете не запускать удаленный скрипт:

Затем перезагрузите код Клода и спросите: «Снимок экрана example.com».

Инструменты

Вам не нужно сначала звонить puppeteer_launch — браузер автоматически запускается по умолчанию, когда запускается любой другой инструмент. По умолчанию ids страницы "default", поэтому потоки однотэбов могут полностью опустить pageId.

Инструмент Что он делает |- |- | puppeteer_launch | (Необязательно) запустить браузер или подключиться к существующему Chrome через browserWSEndpoint.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

puppeteer-mcp-claude

A Model Context Protocol server that gives Claude Code (and any other MCP-aware client) a real browser via Puppeteer — navigate pages, click and type, run JavaScript, capture screenshots, manage cookies, intercept requests.

Requirements

  • Node.js ≥ 18
  • An MCP-aware client (Claude Code, Claude Desktop, Cursor, Codex CLI, …)
  • Chromium is downloaded automatically by Puppeteer on first install (~170 MB)

Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/jaenster/puppeteer-mcp-claude/main/install.sh | bash

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/jaenster/puppeteer-mcp-claude/main/install.ps1 | iex

Both scripts verify Node ≥ 18, install the package globally via npm, and register it with Claude Code at user scope. Override scope with SCOPE=project (bash) or $env:SCOPE='project' (PowerShell).

Manual — if you’d rather not run a remote script:

npm install -g puppeteer-mcp-claude
claude mcp add puppeteer-mcp-claude -- npx -y puppeteer-mcp-claude serve

Then restart Claude Code and ask: “Take a screenshot of example.com”.

Tools

You don’t have to call puppeteer_launch first — the browser auto-launches with defaults the moment any other tool runs. Page ids default to "default", so single-tab flows can omit pageId entirely.

Tool What it does
puppeteer_launch (Optional) launch a browser or connect to an existing Chrome via browserWSEndpoint. Use this for stealth mode, proxies, custom viewport, etc.
puppeteer_new_page Open a new tab.
puppeteer_navigate Go to a URL.
puppeteer_click Click a CSS selector.
puppeteer_type Type into an input.
puppeteer_get_text Read textContent of an element.
puppeteer_screenshot Capture a PNG — returned inline as an MCP image block, optionally also saved to disk.
puppeteer_evaluate Run a JS expression in page context, returns the value.
puppeteer_wait_for_selector Wait until an element appears.
puppeteer_close_page Close a tab.
puppeteer_close_browser Close the whole browser.
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →