Puppeteer MCP (hisma maintained fork) — Claude Code MCP 서버

Puppeteer로 로컬 브라우저를 띄워 페이지 탐색·클릭·입력·스크린샷·JS 실행을 수행하는 MCP 서버. 아카이브된 공식 server-puppeteer의 유지보수 포크.

Puppeteer MCP(hisma maintained fork)는 Claude Code 같은 MCP 호스트가 로컬 Chromium/Chrome 브라우저를 직접 제어하도록 해 주는 Model Context Protocol 서버입니다. Node 기반으로 동작하며, 내부적으로 구글 Puppeteer 라이브러리를 사용해 AI가 자연어 지시만으로 실제 브라우저를 띄우고 조작할 수 있게 합니다.

제공하는 핵심 동작은 페이지 이동(URL 탐색), 요소 클릭·폼 입력·선택, 스크린샷 캡처, 그리고 페이지 컨텍스트에서의 임의 JavaScript 실행입니다. 이를 통해 정적 HTML로는 얻기 어려운 동적·로그인 후·SPA 화면까지 렌더링된 상태로 다룰 수 있어, 웹 스크래핑·UI 동작 확인·반복 작업 자동화·시각적 회귀 점검(스크린샷) 같은 작업을 에이전트가 수행하도록 위임할 수 있습니다.

이 패키지(@hisma/server-puppeteer)는 Anthropic의 공식 예제 모음에 있던 @modelcontextprotocol/server-puppeteer가 아카이브(유지보수 중단)된 뒤, 이를 이어받아 의존성과 동작을 갱신한 커뮤니티 유지보수 포크입니다. 따라서 기존 공식 server-puppeteer에 익숙한 사용자가 큰 변경 없이 옮겨 쓰기에 적합합니다.

쓰면 좋은 대상은 다음과 같습니다. (1) 클라우드 브라우저 서비스 비용 없이 자신의 머신에서 브라우저 자동화를 돌리고 싶은 개발자, (2) 로그인·동적 렌더링이 필요한 페이지를 에이전트로 점검·수집하려는 사람, (3) 프런트엔드 변경을 스크린샷으로 빠르게 확인하려는 팀입니다. 반대로 대규모·고가용 크롤링이나 봇 차단 우회가 필요한 경우에는 Browserbase·Hyperbrowser·Bright Data 같은 관리형 서비스가 더 맞을 수 있습니다. 로컬에 Node 런타임과 브라우저 실행 환경이 필요하며, 헤드리스/헤드풀 동작 등 세부 옵션은 버전에 따라 다를 수 있으니 공식 npm 문서 확인을 권장합니다.

언제 쓰나

로그인 후 화면·SPA·동적 렌더링 페이지를 에이전트로 탐색·수집하거나, 폼 입력·클릭 같은 반복 웹 작업을 자동화하고 싶을 때 적합합니다. 프런트엔드 변경을 스크린샷으로 빠르게 확인하거나, 클라우드 브라우저 비용 없이 내 PC에서 직접 브라우저 자동화를 돌리고 싶을 때 좋습니다. 대규모·고가용 크롤링이나 봇 차단 우회가 핵심이면 관리형 서비스를 검토하세요.

설치

claude mcp add puppeteer -- npx -y @hisma/server-puppeteer

로컬에 Node.js와 Puppeteer가 구동할 Chromium/Chrome 실행 환경이 필요합니다. npx로 설치 시 첫 실행에서 브라우저 바이너리 다운로드나 런타임 의존성(특히 Linux의 공유 라이브러리)이 요구될 수 있어 시간이 걸리거나 실패할 수 있으니, 헤드리스/헤드풀 옵션과 시스템 의존성은 공식 npm 문서 확인을 권장합니다. 이 패키지는 아카이브된 공식 server-puppeteer의 커뮤니티 유지보수 포크이므로, 버전 고정·동작 호환은 배포 노트를 확인한 뒤 적용하세요. 별도 API 키나 환경변수는 요구하지 않습니다.

보안 주의

이 서버는 로컬 브라우저를 띄워 임의 URL을 열고 페이지 컨텍스트에서 JavaScript를 실행하므로 사실상 코드 실행 권한에 준합니다. 별도 API 키([])는 없지만, 에이전트가 방문하는 페이지의 콘텐츠가 곧 모델 입력이 되어 프롬프트 인젝션(악성 페이지가 에이전트에게 다른 행동을 지시) 위험이 큽니다. 신뢰할 수 없는 사이트를 자동 탐색시키지 말고, 로그인 세션·쿠키·저장된 자격증명이 노출·전송되지 않도록 주의하세요. 스크린샷에 민감정보가 담길 수 있고, 클릭/폼 제출이 결제·삭제 같은 비가역 동작을 유발할 수 있으니 가능하면 격리된 프로필·샌드박스 환경에서 실행하길 권장합니다.

자주 묻는 질문

공식 @modelcontextprotocol/server-puppeteer와 무엇이 다른가요?

기능은 사실상 동일합니다. 공식 패키지가 아카이브(유지보수 중단)된 뒤 이를 이어받아 의존성과 동작을 갱신한 커뮤니티 유지보수 포크가 @hisma/server-puppeteer입니다. 기존 설정에서 큰 변경 없이 옮겨 쓰기 적합하며, 세부 호환은 npm 배포 노트를 확인하세요.

별도 API 키나 클라우드 계정이 필요한가요?

아니요. 로컬 브라우저를 직접 띄우는 방식이라 외부 API 키나 유료 계정이 필요 없습니다. 대신 로컬에 Node와 Chromium/Chrome 실행 환경이 있어야 하며, 첫 실행 시 브라우저 바이너리나 시스템 의존성이 요구될 수 있습니다.

대규모 크롤링이나 봇 차단 우회에도 적합한가요?

기본적으로 로컬 단일 브라우저 자동화에 적합합니다. 대규모·고가용 크롤링, 프록시 회전, 봇 차단 우회가 핵심이라면 Browserbase·Hyperbrowser·Bright Data 같은 관리형 서비스가 더 적합할 수 있습니다.