Playwright MCP

극작가-MCP

MCP(Model Context Protocol)용 Playwright 래퍼입니다. 이 서버는 LLM 기반 클라이언트가 자동화 작업을 위해 브라우저를 제어할 수 있도록 지원합니다.

구성 요소

자원

서버는 브라우저 스크린샷에 액세스하기 위한 리소스를 제공합니다.

• 스크린샷 리소스 URI: screenshot://{page_id}
• 모든 열려 있는 페이지에서 스크린샷 리소스를 자동으로 사용할 수 있습니다.

프롬프트

서버는 클라이언트가 웹 페이지를 해석하는 데 도움이 되는 프롬프트를 제공합니다.

• interpret-page : 현재 웹 페이지의 내용과 구조를 분석합니다.
  • 해석할 페이지를 선택하기 위한 선택적 page_id 인수
  • 특정 측면(전체, 양식, 탐색, 텍스트)에 초점을 맞추기 위한 선택적 focus 인수
  • 텍스트 분석과 페이지 스크린샷을 모두 반환합니다.

도구

서버는 포괄적인 브라우저 자동화 도구 세트를 구현합니다.

• 브라우저 탐색
  • navigate : 특정 URL로 이동
  • new_page : 특정 ID로 새로운 브라우저 페이지를 만듭니다.
  • switch_page : 다른 브라우저 페이지로 전환
  • get_pages : 사용 가능한 모든 브라우저 페이지 나열
• 페이지 상호작용
  • click : CSS 선택기를 사용하여 요소를 클릭합니다.
  • type : 입력 요소에 텍스트를 입력합니다.
  • wait_for_selector : 페이지에 요소가 나타날 때까지 기다립니다.
• 콘텐츠 추출
  • get_text : 요소에서 텍스트 콘텐츠를 가져옵니다.
  • get_page_content : 전체 페이지 HTML 가져오기
  • take_screenshot : 페이지 또는 요소의 시각적 상태를 캡처합니다.

구성

종속성 설치

지엑스피1

빠른 시작

설치하다

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

2. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN
• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.