Configurable Puppeteer MCP Server

by afshawnlotfi
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports interaction with web elements using CSS selectors for operations like clicking, hovering, filling form fields, and capturing specific elements in screenshots.

  • Offers the ability to use Firefox instead of Chrome as the browser engine through custom Puppeteer configuration options.

  • Enables execution of JavaScript code in the browser context through the puppeteer_evaluate tool, allowing for dynamic interaction with web page content.

구성 가능한 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 이미지
    • 캡처 중에 지정된 스크린샷 이름을 통해 접근 가능

주요 특징

  • 브라우저 자동화
  • 콘솔 로그 모니터링
  • 스크린샷 기능
  • 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 파일을 참조하세요.

-
security - not tested
F
license - not found
-
quality - not tested

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

  1. Components
    1. Tools
    2. Resources
  2. Key Features
    1. Configuration
      1. Using with Custom Puppeteer Options
      2. Standard Configuration
    2. License
      ID: be53p5xcw8