퍼펫티어 MCP 서버

Puppeteer MCP 서버(Python 구현)

Playwright(Puppeteer에 해당하는 Python 버전)를 사용하여 브라우저 자동화 기능을 제공하는 모델 컨텍스트 프로토콜(MLP) 서버입니다. 이 서버를 통해 LLM은 실제 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있습니다.

개요

이 Python 구현은 TypeScript 버전에 대한 안정적인 대안을 제공하며, 향상된 오류 처리 및 로깅 기능을 통해 동일한 기능을 제공합니다. Puppeteer의 Python 버전인 Playwright를 사용하여 강력한 브라우저 자동화 기능을 제공합니다.

주요 특징

전체 브라우저 자동화
페이지 탐색
스크린샷 캡처(전체 페이지 또는 요소)
양식 상호작용(클릭 및 채우기)
JavaScript 실행
콘솔 로그 모니터링
구성 가능한 시간 초과
자세한 오류 처리
종합 로깅

필수 조건

파이썬 3.8 이상
pip(Python 패키지 설치 프로그램)

설치

필요한 패키지를 설치하세요:

지엑스피1

Playwright 브라우저 설치:

playwright install

용법

서버 시작

서버를 직접 실행합니다.

python puppeteer_server.py

클로드 데스크톱 구성

Claude 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "puppeteer": {
      "command": "python",
      "args": ["path/to/puppeteer.py"]
    }
  }
}

사용 가능한 도구

꼭두각시 조종자_탐색

브라우저에서 원하는 URL로 이동합니다.

{
  "name": "puppeteer_navigate",
  "arguments": {
    "url": "https://example.com",
    "timeout": 60000  // optional, defaults to 60000ms
  }
}

인형극단 스크린샷

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

{
  "name": "puppeteer_screenshot",
  "arguments": {
    "name": "my_screenshot",
    "selector": "#specific-element",  // optional
    "width": 1280,  // optional, default: 1280
    "height": 720,  // optional, default: 720
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

꼭두각시_클릭

페이지의 요소를 클릭합니다.

{
  "name": "puppeteer_click",
  "arguments": {
    "selector": ".button-class",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

인형극_채우기

입력 필드를 작성하세요.

{
  "name": "puppeteer_fill",
  "arguments": {
    "selector": "#input-id",
    "value": "text to fill",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

인형극 평가자

브라우저 콘솔에서 JavaScript를 실행합니다.

{
  "name": "puppeteer_evaluate",
  "arguments": {
    "script": "document.title",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

오류 처리

서버는 일반적인 시나리오에 대한 자세한 오류 메시지를 제공합니다.

내비게이션 실패
요소를 찾을 수 없습니다
시간 초과 오류
JavaScript 실행 오류
스크린샷 실패

벌채 반출

포괄적인 로깅은 다양한 수준으로 구현됩니다.

정보: 표준 작업
오류: 작업 실패
DEBUG: 자세한 실행 정보

노트

더 나은 디버깅을 위해 브라우저가 헤드리스 모드가 아닌 모드로 시작됩니다.
기본 뷰포트 크기는 1280x720입니다.
모든 시간 초과는 구성 가능합니다.
콘솔 로그가 캡처되어 저장됩니다.
스크린샷은 base64 인코딩으로 메모리에 저장됩니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출하기 전에 저장소의 기여 지침을 꼭 읽어주세요.

특허

이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

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

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-playwright
executeautomation
A
security
A
license
A
quality
A Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
Last updated -
13
9,457
3,642
TypeScript
MIT License
Playwright MCP Server
lebrodus
A
security
F
license
A
quality
A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
Last updated -
12
9,457
1
TypeScript
BrowserCat MCP Server (Browser Automation)official
browsercat
-
security
F
license
-
quality
A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
Last updated -
39
Puppeteer MCP Server
cploujoux
-
security
F
license
-
quality
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.
Last updated -
15,502
JavaScript

View all related MCP servers

Puppeteer MCP Server