MCP Playwright: 브라우저 자동화 작업을 제공하는 MCP 서비스

최신 AI 리소스5개월 전에 게시 됨 AI 공유 서클
1.7K 00

일반 소개

MCP-Playwright는 ExecuteAutomation에서 개발하여 GitHub에서 호스팅하는 오픈 소스 툴입니다. 이 도구는 Playwright와 모델 컨텍스트 프로토콜 (MCP) 프로토콜로, 사용자가 자연어 명령을 통해 브라우저 자동화 및 API 테스트를 구현할 수 있도록 하는 것을 목표로 합니다. 이 도구는 개발자와 테스터 모두에게 적합하며 다음을 연결할 수 있습니다. Claude 및 기타 대형 언어 모델(LLM)을 사용하여 웹 페이지 열기, 버튼 클릭, 양식 작성, 스크린샷 찍기, 간단한 텍스트를 통한 API 요청 전송 등의 브라우저 작업을 제어할 수 있습니다. 사용자가 복잡한 코드를 작성할 필요가 없으므로 사용의 문턱이 낮아집니다. 이 프로젝트는 현재 개발 단계에 있으며 기능이 점진적으로 개선되고 있으며 커뮤니티의 코드 기여를 환영합니다.

MCP Playwright:提供浏览器自动化操作的MCP服务

 

기능 목록

  • 브라우저 자동화특정 웹 페이지로 이동, 요소 클릭, 입력 상자 채우기, 드롭다운 옵션 선택 등을 지원합니다.
  • API 테스트GET, POST, PUT, PATCH, DELETE 요청을 보내고 응답을 검사할 수 있습니다.
  • 스크린샷 기능전체 웹 페이지 또는 특정 영역을 가로채서 이미지로 저장할 수 있습니다.
  • 자바스크립트 실행브라우저에서 사용자 지정 자바스크립트 코드를 실행하는 기능입니다.
  • 콘솔 로그 가져오기: 브라우저에서 오류, 경고 또는 디버깅 정보를 추출합니다.
  • 자연어 제어MCP 프로토콜을 통해 Claude와 같은 모델에 연결하고 텍스트 명령으로 작동합니다.

 

도움말 사용

MCP-Playwright를 사용하려면 간단한 설치와 구성이 필요합니다. 다음은 빠르게 시작하는 데 도움이 되는 자세한 단계입니다.

설치 프로세스

이 도구를 실행하려면 환경을 준비하고 관련 구성 요소를 설치해야 합니다. 다음은 이를 수행하는 방법에 대한 자세한 내용입니다:

  1. 환경 확인
    • 컴퓨터에 Node.js가 설치되어 있는지 확인합니다(안정적인 최신 버전 권장).
    • Claude 데스크톱 클라이언트와 같은 MCP 지원 클라이언트가 필요합니다.
    • 코드 다운로드를 위해 Git을 설치합니다(선택 사항).
  2. 프로젝트 다운로드(수동 설치 옵션)
    • 터미널을 열고 실행합니다:
      git clone https://github.com/executeautomation/mcp-playwright.git
      
    • 프로젝트 카탈로그로 이동합니다:
      cd mcp-playwright
      
  3. 종속성 설치
    • 프로젝트 디렉토리에서 실행합니다:
      npm install
      
    • 그러면 Playwright 및 기타 필요한 구성 요소가 설치됩니다.
  4. npm을 통해 직접 설치(권장)
    • 수동으로 다운로드하고 싶지 않다면 그냥 실행하면 됩니다:
      npm install -g @executeautomation/playwright-mcp-server
      
    • 이렇게 하면 서버가 전역적으로 설치됩니다.
  5. 스미서리를 통한 설치(클로드 데스크톱용)
    • 다음 명령을 실행하면 자동으로 설치 및 구성됩니다:
      npx -y @smithery/cli install @executeautomation/playwright-mcp-server --client claude
      
  6. Claude 데스크톱 구성
    • 클로드 데스크톱의 구성 파일을 찾습니다(일반적으로 사용자 디렉터리의 클로드 폴더에 있는 파일명 claude-desktop-config.json).
    • 다음을 추가합니다:
      {
      "mcpServers": {
      "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
      }
      }
      }
      
    • Claude Desktop을 저장하고 다시 시작하면 인터페이스에 "MCP에서 연결" 버튼이 나타나 구성이 성공했음을 나타냅니다.

사용 방법

설치가 완료되면 자연어 명령을 사용하여 브라우저를 제어하거나 API를 테스트할 수 있습니다. 자세한 방법은 다음과 같습니다.

브라우저 자동화

  • 웹 페이지 열기
    클로드 데스크톱에서 입력합니다:
打开网页 https://example.com

도구가 브라우저를 실행하고 페이지를 로드합니다.

  • 요소 클릭
    입력:
点击页面上的登录按钮,使用选择器 #loginBtn

ID를 찾습니다. loginBtn 버튼을 클릭합니다.

  • 양식 작성하기
    입력:
在用户名输入框填写 "admin",使用选择器 #username
在密码输入框填写 "123456",使用选择器 #password

이 도구는 자동으로 콘텐츠를 채웁니다.

  • 스크린샷(컴퓨팅)
    입력:
截取整个网页,保存为 "page.png"

스크린샷은 현재 디렉터리에 저장됩니다.

  • 자바스크립트 실행
    입력:
在浏览器中执行 JavaScript 代码 "document.title"

페이지 제목을 반환합니다.

  • 로그 가져오기
    입력:
获取浏览器控制台日志,只显示错误信息

이 도구는 오류 로그를 반환합니다.

API 테스트

  • GET 요청 보내기
    입력:
对 https://api.example.com/data 发送 GET 请求

상태 코드와 데이터를 반환합니다.

  • POST 요청 보내기
    입력:
对 https://api.example.com/users 发送 POST 请求,数据为 {"name": "TestUser"}
检查响应中包含 "id"

이 도구는 결과를 검증합니다.

  • 업데이트된 데이터
    입력:
对 https://api.example.com/users/1 发送 PUT 请求,数据为 {"name": "NewUser"}

데이터가 업데이트됩니다.

운영 예제

로그인 프로세스를 테스트하고 싶다고 가정해 보겠습니다:

  1. 입력:
打开网页 http://eaapp.somee.com
  1. 입력:
点击页面上的登录链接,使用选择器 #loginLink
  1. 입력:
在用户名输入框填写 "admin",使用选择器 #username
在密码输入框填写 "password",使用选择器 #password
点击登录按钮,使用选择器 #loginBtn
  1. 입력:
截取整个网页,保存为 "login_result.png"
  1. 입력:
关闭浏览器

전체 프로세스는 자연어를 통해 이루어지며 간단하고 직관적입니다.

테스트 도구

이 프로젝트는 테스트에 Jest를 사용합니다. 기능을 확인하려는 경우 테스트를 실행할 수 있습니다:

  • 터미널에 입력합니다:
npm test
  • 밴드 커버리지 보고서:
    npm run test:coverage
    

테스트 보고서는 coverage 카탈로그.

주의

  • 복잡한 인증 요청(예: OAuth)은 현재 도구에서 지원되지 않습니다.
  • 문제가 발생하면 공식 문서(https://executeautomation.github.io/mcp-playwright/)를 확인하세요.
  • 이 프로젝트는 오픈 소스이므로 포크하고 개선을 위한 제안을 제출할 수 있습니다.
© 저작권 정책
AiPPT

관련 문서

댓글 없음

댓글에 참여하려면 로그인해야 합니다!
지금 로그인
없음
댓글 없음...