jaenster/puppeteer-mcp-claude

Browser automation

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

49 stars 5 forks 品質 64 トレンド 17MIT

Repository Install

Puppeteerによって供給されるClaudeのためのブラウザのオートメーションMCPサーバー.

概要

Claudeコード(およびその他のMCP-awareクライアント)をPuppeteerを介して実際のブラウザに提供するモデルコンテキストプロトコルサーバー — ページを移動し、JavaScriptを実行し、スクリーンショットをキャプチャし、Cookieを管理し、リクエストをインターセプトします。 - Node.js ≥ 18 - MCP-aware クライアント (Claude コード、Claude デスクトップ、Cursor、Codex CLI、...) - クロムは、最初のインストール時に Puppeteer によって自動的にダウンロードされます(〜170 MB) どちらのスクリプトも Node ≥ 18, npm でパッケージをグローバルにインストールし、Claude Code でユーザースコープに登録します。 SCOPE=project (bash) または $env:SCOPE='project' (PowerShell) でスコープをオーバーライドします。 — リモートスクリプトを実行していない場合: その後、Claudeコードを再起動し、次のように尋ねます: "例のスクリーンショットを撮る"。 puppeteer launch を最初に呼び出す必要はありません。デフォルトでは、他のツールが実行される瞬間を自動実行します。ページ ID のデフォルトは "default" なので、単一タブフローは pageId を完全に省略できます。すべてのツールは、2つの並列フォームで結果を返します。 - コンテンツ[0].

概要（AI 翻訳）

Claudeコード(およびその他のMCP-awareクライアント)をPuppeteerを介して実際のブラウザに提供するモデルコンテキストプロトコルサーバー — ページを移動し、JavaScriptを実行し、スクリーンショットをキャプチャし、Cookieを管理し、リクエストをインターセプトします。

要件

Node.jsの≥ 18
MCP-awareクライアント(クロードコード、クロードデスクトップ、カーソル、コーデックスCLI、…)
クロムはPuppeteerによって最初の取付け(~170 MB)で自動的にダウンロードされます

インストール

macOS/Linux

Windows(PowerShell)

どちらのスクリプトも Node ≥ 18, npm でパッケージをグローバルにインストールし、Claude Code でユーザースコープに登録します。 [SCOPE=project (bash) または $env:SCOPE='project' (PowerShell) でスコープをオーバーライドします。

Manual — リモートスクリプトを実行していない場合:

その後、Claudeコードを再起動し、要求します: 「例のスクリーンショットを撮る」。

ツール

最初に[puppeteer_launchを呼び出す必要はありません。ブラウザはデフォルトで自動実行され、他のツールが実行されます。ページ ID は "default" にデフォルトで、単一タブフローは pageId を完全に省略できます。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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.

GitHub で README 全文を見る

インストール

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

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →