
jaenster/puppeteer-mcp-claude
Browser automationЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер 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. |
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →