MCP Puppeteer Linux Server

MCP-퍼펫티어-리눅스

Puppeteer를 사용하여 브라우저 자동화 기능을 제공하는 모델 컨텍스트 프로토콜(MLP) 서버로, Linux 디스플레이 서버(X11 및 Wayland)를 완벽하게 지원합니다. 이 서버를 통해 LLM은 실제 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있습니다.

디스플레이 서버 지원

이 포크는 Linux 디스플레이 서버에 대한 자동 감지 및 구성을 추가합니다.

• 자동 X11/Wayland 감지
• 동적 환경 변수 구성
• 다양한 데스크톱 환경 지원(GNOME, KDE 등)
• 폴백 메커니즘 및 강력한 오류 처리
• XWayland 호환성

구성 요소

도구

• 꼭두각시 조종자_탐색
  • 브라우저에서 모든 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 이미지
   • 캡처 중에 지정된 스크린샷 이름을 통해 접근 가능

주요 특징

• Linux 디스플레이 서버 지원을 통한 브라우저 자동화
• 자동 X11/Wayland 감지 및 구성
• 콘솔 로그 모니터링
• 스크린샷 기능
• JavaScript 실행
• 기본 웹 상호작용(탐색, 클릭, 양식 작성)

구성

클로드 데스크톱 구성

지엑스피1

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Puppeteer Linux를 자동으로 설치하려면:

수동 설치

1. 저장소를 복제합니다.

2. 종속성 설치:

3. 서버를 시작합니다:

서버 세부 정보 표시

서버는 자동으로 적절한 디스플레이 환경을 감지하고 구성합니다.

Wayland 지원

• WAYLAND_DISPLAY 통해 Wayland 세션을 감지합니다.
• 필요한 환경 변수를 구성합니다.
  • WAYLAND_DISPLAY
  • QT_QPA_PLATFORM
  • GDK_BACKEND
  • MOZ_ENABLE_WAYLAND
  • XDG_SESSION_TYPE

X11 지원

• 기존 X11 세션에 대한 대체
• X11 관련 변수를 처리합니다.
  • DISPLAY
  • XAUTHORITY
• 다양한 데스크톱 환경 및 창 관리자 지원

특허

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