jaenster/puppeteer-mcp-claude

Browser automation

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

49 stars 5 forks 품질 64 트렌드 17MIT

Repository Install

브라우저 자동화 MCP 서버 Claude, Puppeteer에 의해 구동.

개요

Claude Code (및 기타 MCP-aware 클라이언트)를 제공하는 모델 Context Protocol 서버는 Puppeteer를 통해 실제 브라우저 - 페이지를 탐색, 클릭 및 유형, 자바 스크립트를 실행, 스크린 샷을 캡처, 쿠키를 관리, 요청을 가로 질러. - Node.js ≥ 18 - MCP-aware 클라이언트 (Claude Code, Claude Desktop, Cursor, Codex CLI, ...) - 크롬은 첫 설치에 Puppeteer에 의해 자동으로 다운로드됩니다 (~170 MB) 두 스크립트는 Node ≥ 18, npm을 통해 패키지를 globally 설치하고 사용자 범위에서 Claude Code로 등록합니다. SCOPE=project (bash) 또는 $env:SCOPE='project' (PowerShell)를 가진 override 범위. - 원격 스크립트를 실행하지 않는 경우: 그런 다음 Claude Code를 다시 시작하고 요청하십시오. "예 : example.com의 스크린 샷을하십시오. puppeteer launch를 먼저 호출 할 필요가 없습니다 - 기본으로 브라우저 자동 발사는 다른 도구가 실행됩니다. 페이지 ids default to "default", 그래서 단일탭 흐름은 완전히 페이지를 omit 수 있습니다. 모든 도구는 두 개의 병렬 형태로 결과를 반환합니다. - 내용[0].

개요(AI 번역)

Claude Code (및 기타 MCP-aware 클라이언트)를 제공하는 모델 Context Protocol 서버는 Puppeteer를 통해 실제 브라우저 - 페이지를 탐색, 클릭 및 유형, 자바 스크립트를 실행, 스크린 샷을 캡처, 쿠키를 관리, 요청을 가로 질러.

요구 사항

노드.js ≥ 18
MCP-aware 클라이언트 (Claude Code, Claude Desktop, Cursor, Codex CLI, …)
크롬은 Puppeteer가 처음 설치하여 자동으로 다운로드됩니다 (~170 MB)

설치

**macOS / 리눅스 **

**윈도우 (PowerShell) **

두 스크립트는 Node ≥ 18, npm을 통해 패키지를 globally 설치하고 사용자 범위에서 Claude Code로 등록합니다. SCOPE=project (bash) 또는 $env:SCOPE='project' (PowerShell)를 가진 덮음 범위.

Manual — 원격 스크립트를 실행하지 않는 경우:

그런 다음 Claude Code를 다시 시작하고 요청하십시오. * “예 : example.com”*의 스크린 샷을하십시오.

도구

먼저 puppeteer_launch 을 호출해야 합니다. - 기본으로 브라우저 자동 발사는 다른 도구가 실행됩니다. Page ids default to "default", 그래서 단일탭 흐름은 pageId를 완전히 옮길 수 있습니다.

도구	그것은 무엇
`puppeteer_launch`	(선택 사항) 브라우저를 실행하거나 [T6]]를 통해 기존 크롬에 연결하십시오.

이 페이지는 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 가이드부터 시작하세요 →