Skip to main content
Glama
Configurable Puppeteer MCP Server

Configurable Puppeteer MCP Server

by afshawnlotfi

구성 가능한 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 파일을 참조하세요.

Available Tools

7 tools
puppeteer_clickC

Click an element on the page

Inputs: selector (required).

puppeteer_evaluateB

Execute JavaScript in the browser console

Inputs: script (required).

puppeteer_fillC

Fill out an input field

Inputs: selector (required), value (required).

puppeteer_hoverC

Hover an element on the page

Inputs: selector (required).

puppeteer_navigateB

Navigate to a URL

Inputs: url (required).

puppeteer_screenshotB

Take a screenshot of the current page or a specific element

Inputs: name (required), selector, width, height.

puppeteer_selectC

Select an element on the page with Select tag

Inputs: selector (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 7 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. Clicking, evaluating JavaScript, filling inputs, hovering, navigating, taking screenshots, and selecting dropdown elements are all separate browser automation operations that an agent can easily distinguish. The descriptions clearly differentiate each action.

    Naming Consistency5/5

    All tools follow a perfect verb_noun pattern with consistent snake_case naming (puppeteer_click, puppeteer_evaluate, etc.). The 'puppeteer_' prefix creates a clear namespace, and the action verbs (click, evaluate, fill, hover, navigate, screenshot, select) are consistently descriptive and parallel in structure.

    Tool Count5/5

    Seven tools is well-scoped for a Puppeteer automation server. This provides core browser interaction capabilities without being overwhelming. Each tool earns its place by covering essential operations like navigation, interaction, evaluation, and capture that form a complete automation workflow.

    Completeness4/5

    The toolset covers most essential Puppeteer operations well, including navigation, interaction, evaluation, and screenshots. Minor gaps exist - there's no explicit tool for waiting/loading states, keyboard input, or cookie/session management - but agents can work around these using evaluate or other tools. Core browser automation workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
      19
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
      7
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, generate test code, scrape web content, and execute JavaScript in real browser environments.
      31
      MIT