MCP-Server-Playwright

목차

• 특징

• 설치

• 구성

• 구성 요소

  • 도구

  • 자원

• 특허

Related MCP server: Puppeteer MCP Server

특징

• 🌐 전체 브라우저 자동화 기능

• 📸 전체 페이지 또는 특정 요소의 스크린샷 캡처

• 🖱️ 포괄적인 웹 상호작용(탐색, 클릭, 양식 작성)

• 📊 콘솔 로그 모니터링

• 🔧 브라우저 컨텍스트에서의 JavaScript 실행

설치

Smithery를 통해 설치

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

지엑스피1

npx 또는 mcp-get을 사용하여 패키지를 설치할 수 있습니다.

npx 사용:

npx @automatalabs/mcp-server-playwright install

이 명령은 다음을 수행합니다.

1. 운영 체제 호환성 확인(Windows/macOS)

2. Claude 구성 파일을 생성하거나 업데이트합니다.

3. Playwright 서버 통합 구성

구성 파일은 다음 위치에서 자동으로 생성/업데이트됩니다.

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

mcp-get을 사용합니다.

npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright

구성

설치 과정에서 다음 구성이 Claude 구성 파일에 자동으로 추가됩니다.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

구성 요소

도구

browser_navigate

브라우저에서 모든 URL로 이동합니다.

{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

전체 페이지 또는 특정 요소의 스크린샷을 캡처합니다.

{
  "name": "screenshot-name",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: false
}

browser_click

CSS 선택기를 사용하여 페이지의 요소를 클릭합니다.

{
  "selector": "#button-id"
}

browser_click_text

페이지의 텍스트 콘텐츠를 클릭하여 요소를 클릭합니다.

{
  "text": "Click me"
}

browser_hover

CSS 선택기를 사용하여 페이지의 요소 위에 마우스를 올려놓으세요

{
  "selector": "#menu-item"
}

browser_hover_text

페이지의 텍스트 콘텐츠에 있는 요소 위에 마우스를 올려 놓으세요.

{
  "text": "Hover me"
}

browser_fill

입력 필드를 작성하세요

{
  "selector": "#input-field",
  "value": "Hello World"
}

browser_select

CSS 선택기를 사용하여 SELECT 요소에서 옵션 선택

{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

SELECT 요소의 텍스트 내용을 통해 옵션을 선택합니다.

{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

브라우저 콘솔에서 JavaScript 실행

{
  "script": "document.title"
}

자원

1. 콘솔 로그 ( console://logs )

   • 텍스트 형식으로 브라우저 콘솔 출력에 액세스합니다.

   • 브라우저의 모든 콘솔 메시지를 포함합니다.

2. 스크린샷 ( screenshot://<n> )

   • 캡처된 스크린샷의 PNG 이미지에 액세스

   • 캡처 중에 지정된 이름으로 참조됨

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.