극작가 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 서버를 사용하기 전에 필요한 환경 변수가 설정되어 있는지 확인하세요.

• 웹 페이지 콘텐츠를 검색할 때 대상 웹사이트의 서비스 약관을 준수하세요.

• 여러 요청을 보낼 때 적절한 간격을 유지하세요

• 마우스 작업을 수행할 때 실제 사용자 상호 작용을 시뮬레이션하므로 적절한 간격을 유지하십시오.

특허

아이에스씨