Playwright MCP Server

극작가 MCP 서버

영어 | 일본어

이 프로젝트는 MCP(Model Context Protocol)를 사용하여 Playwright 웹 페이지 콘텐츠 검색 기능을 제공하는 서버입니다.

특징

• 페이지 탐색
• 전체 페이지 콘텐츠 검색
• 가시적인 콘텐츠 검색
• 대화형 요소 감지
• 마우스 조작 시뮬레이션
• 테스트를 위한 에코 기능

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Playwright MCP Server를 자동으로 설치하려면:

지엑스피1

수동 설치

용법

서버 시작

MCP 도구

다음과 같은 도구를 사용할 수 있습니다.

1. navigate
   • 지정된 URL로 이동
   • 인수: { url: string }
   • 반환: 탐색 결과
2. get_all_content
   • 전체 페이지에서 콘텐츠 검색
   • 인수: 없음
   • 반환: 페이지의 모든 텍스트 콘텐츠
3. get_visible_content
   • 현재 표시된 콘텐츠 검색
   • 인수: { minVisiblePercentage?: number }
   • 반환: 표시되는 텍스트 콘텐츠
4. get_interactive_elements
   • 페이지에서 대화형 요소(버튼, 링크 등)의 위치 정보를 가져옵니다.
   • 인수: 없음
   • 반환: 대화형 요소의 좌표 및 경계 정보
5. move_mouse
   • 마우스 커서를 지정된 좌표로 이동합니다.
   • 인수: { x: number, y: number }
   • 반환: 작업 결과
6. mouse_click
   • 지정된 좌표에서 마우스 클릭을 실행합니다.
   • 인수: { x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }
   • 반환: 클릭 작업 결과
7. mouse_wheel
   • 마우스 휠 스크롤 실행
   • 인수: { deltaY: number, deltaX?: number }
   • 반환값: 스크롤 작업 결과
8. drag_and_drop
   • 드래그 앤 드롭 작업 실행
   • 인수: { sourceX: number, sourceY: number, targetX: number, targetY: number }
   • 반환: 드래그 앤 드롭 작업 결과
9. echo
   • 테스트를 위한 에코 도구
   • 인수: { message: string }
   • 반환: 메시지를 보냈습니다

개발

테스트 실행

테스트 구조

• tools/*.test.ts : 각 도구에 대한 기능 테스트
• mcp-server.test.ts : MCP 서버 기능 테스트

구현 기능

1. 콘텐츠 검색
   • 전체 페이지 콘텐츠 검색
   • 보이는 콘텐츠만 검색
   • 적절한 HTML 구문 분석
2. 상호 작용
   • 상호작용 요소의 탐지 및 위치 정보 검색
   • 마우스 조작 시뮬레이션(이동, 클릭, 스크롤)
   • 드래그 앤 드롭 지원
3. 오류 처리
   • 적절한 탐색 오류 처리
   • 시간 초과 처리
   • 잘못된 URL 감지
4. 구성 유연성
   • 헤드리스/헤드 모드 선택
   • 사용자 정의 사용자 에이전트
   • 뷰포트 크기 설정

중요 참고 사항

• MCP 서버를 사용하기 전에 필요한 환경 변수가 설정되어 있는지 확인하세요.
• 웹 페이지 콘텐츠를 검색할 때 대상 웹사이트의 서비스 약관을 준수하세요.
• 여러 요청을 보낼 때 적절한 간격을 유지하세요
• 마우스 작업을 수행할 때 실제 사용자 상호 작용을 시뮬레이션하므로 적절한 간격을 유지하십시오.

특허

아이에스씨