MCP Puppeteer — MCP 프로토콜

MCP·Skill / MCP 프로토콜 / server-puppeteer.html

MCP 프로토콜원문등록 2026-10-18

Puppeteer로 웹을 탐색·스크린샷하는 서버

기본 정보

프로그램 이름MCP Puppeteer (MCP puppeteer)
한 줄 소개Puppeteer로 웹을 탐색·스크린샷하는 서버
개발·유지Model Context Protocol 프로젝트
공식 홈페이지https://github.com/modelcontextprotocol/servers
공식 문서https://github.com/modelcontextprotocol/servers
설치·배포npx -y @modelcontextprotocol/server-puppeteer
동작 환경MCP 호스트 앱 (Claude Desktop, Cursor, opencode 등)
라이선스MIT 라이선스
안정 버전npm modelcontextprotocol/server-puppeteer (2026-10 확인) — 확인일 2026-10-18
GitHub 저장소https://github.com/modelcontextprotocol/servers
분류MCP 프로토콜 (태그: MCP, 레퍼런스 서버, 도구, 에이전트)

이 프로그램은 무엇인가?

이 서버는 MCP 공식 레퍼런스 서버 모음에 포함된 Puppeteer로 웹을 탐색·스크린샷하는 서버 구현체입니다. npx 한 줄로 실행할 수 있으며, MCP 호스트 앱의 설정에 등록하면 에이전트가 즉시 사용할 수 있습니다.

주 용도: 에이전트의 웹 자동화·스크래핑

어떤 문제를 해결하는가?

  • ('puppeteer 작업에서', '에이전트가 Puppeteer로 웹을 탐색·스크린샷하는 서버 기능을 사용해야 할 때', '표준 MCP 도구로 즉시 연결')
  • ('빠른 연결', '별도 서버 구축 없이 npx로 실행해야 할 때', '공식 구현체 재사용')
  • ('안전한 접근', '허용 범위를 제한하며 접근해야 할 때', '경로·권한 파라미터로 제한')

주요 기능

도구 노출

navigate, screenshot, click, fill

  • 활용 상황: 에이전트의 웹 자동화·스크래핑을(를) 에이전트에게 제공
  • 얻는 결과: 표준 MCP 도구 호출
  • 제한 사항: 권한 설정 주의

설치 및 실행

npx (실행)

@modelcontextprotocol/server-puppeteer을 npx로 실행합니다.

npx -y @modelcontextprotocol/server-puppeteer /path

실제 사용 예제

호스트에 등록

mcp.json에 서버 항목을 추가합니다.

{"mcpServers":{"puppeteer":{"command":"npx","args":["-y","@modelcontextprotocol/server-puppeteer","/path"]}}

장점과 한계

장점

  • 공식 프로젝트 구현체
  • npx 한 줄 실행
  • 표준 MCP 도구 노출

사용 전에 고려할 점

  • 호스트 앱 설정 필요
  • 권한·경로 설정 주의

비슷한 프로그램과 비교

프로그램특징이런 경우에 적합
직접 구현필요한 도구만 직접 작성사내 특수 도구
커뮤니티 서버다른 구현체 선택대안 탐색

공식 자료 및 추가 학습

버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

MCP Puppeteer 사용 예시

실제 운영 중인 서버

이 문서는 화면 표시용 가상 디렉터리의 항목입니다. 실제 서버 파일시스템과 연결되지 않으며, 파일 실행이나 시스템 명령을 수행하지 않습니다.