구성 가능한 Puppeteer MCP 서버

Puppeteer를 사용하여 브라우저 자동화 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 설정 가능한 옵션이 있습니다. 이 서버를 통해 LLM은 실제 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있으며, 환경 변수를 통해 Puppeteer 실행 옵션을 사용자 지정할 수 있습니다.

구성 요소

도구

• 꼭두각시 조종자_탐색

  • 브라우저에서 모든 URL로 이동합니다.

  • 입력: url (문자열)

• 인형극단 스크린샷

  • 전체 페이지 또는 특정 요소의 스크린샷을 캡처합니다.

  • 입력:

    • name (문자열, 필수): 스크린샷의 이름

    • selector (문자열, 선택 사항): 스크린샷을 찍을 요소에 대한 CSS 선택기

    • width (숫자, 선택 사항, 기본값: 800): 스크린샷 너비

    • height (숫자, 선택 사항, 기본값: 600): 스크린샷 높이

• 꼭두각시_클릭

  • 페이지의 요소를 클릭하세요

  • 입력: selector (문자열): 클릭할 요소에 대한 CSS 선택기

• 인형극 배우기_호버

  • 페이지에 요소 올려놓기

  • 입력: selector (문자열): 호버할 요소에 대한 CSS 선택기

• 인형극_채우기

  • 입력 필드를 작성하세요

  • 입력:

    • selector (문자열): 입력 필드에 대한 CSS 선택기

    • value (문자열): 채울 값

• 꼭두각시 선택

  • SELECT 태그로 요소를 선택하세요

  • 입력:

    • selector (문자열): 선택할 요소에 대한 CSS 선택기

    • value (문자열): 선택할 값

• 인형극 평가자

  • 브라우저 콘솔에서 JavaScript 실행

  • 입력: script (문자열): 실행할 JavaScript 코드

자원

서버는 두 가지 유형의 리소스에 대한 액세스를 제공합니다.

1. 콘솔 로그 ( console://logs )

   • 텍스트 형식의 브라우저 콘솔 출력

   • 브라우저의 모든 콘솔 메시지를 포함합니다.

2. 스크린샷 ( screenshot://<name> )

   • 캡처된 스크린샷의 PNG 이미지

   • 캡처 중에 지정된 스크린샷 이름을 통해 접근 가능

Related MCP server: Steel Puppeteer

주요 특징

• 브라우저 자동화

• 콘솔 로그 모니터링

• 스크린샷 기능

• JavaScript 실행

• 기본 웹 상호작용(탐색, 클릭, 양식 작성)

• 환경 변수를 통한 구성 가능한 Puppeteer 옵션

구성

사용자 정의 퍼펫티어 옵션과 함께 사용

PUPPETEER_ARGS 환경 변수에 JSON 문자열을 제공하여 Puppeteer 실행 옵션을 구성할 수 있습니다. 이를 통해 서버 코드를 수정하지 않고도 브라우저 동작을 사용자 지정할 수 있습니다.

예: Chrome 대신 Firefox 사용

지엑스피1

예: 브라우저 창 크기 구성

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
      }
    }
  }
}

표준 구성

엔피엑스

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"]
    }
  }
}

또한 브랜치, 태그 또는 커밋을 지정할 수도 있습니다.

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"]
    }
  }
}

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.