프로젝트 소개

Playwright MCP는 Playwright를 통해 브라우저 자동화를 제공하는 Model Context Protocol(MCP) 서버입니다. 스크린샷이나 비전 튜닝 모델에 의존하는 대신, LLM 클라이언트가 구조화된 접근성 스냅샷을 사용하여 웹 페이지와 상호작용할 수 있게 하며, 프로젝트는 이를 빠르고 가볍고 LLM 친화적이며 결정적이라고 설명합니다. README는 MCP 서버를 별도의 Playwright CLI 및 SKILLs 접근 방식과 대조합니다. 코딩 에이전트는 토큰 효율이 더 높기 때문에 CLI 기반 워크플로를 선호하는 경우가 많지만, MCP는 탐색적 자동화, 자가 치유 테스트, 장기 실행 자율 워크플로와 같이 영구 상태, 풍부한 내부 검사, 페이지 구조에 대한 반복적 추론이 필요한 에이전트 루프에 여전히 유용하다고 설명합니다. 요구 사항은 Node.js 18 이상과 VS Code, Cursor, Windsurf, Claude Desktop, Goose, Grok, Junie 등의 MCP 클라이언트입니다. 설치는 일반적으로 npx @playwright/mcp@latest로 수행하며, README는 VS Code, Cursor, Claude Code, Claude Desktop, Cline, Codex, Copilot, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, Warp, Windsurf를 포함한 많은 도구에 대한 클라이언트별 설정 스니펫을 제공합니다. 구성 옵션은 광범위합니다. 명령줄 옵션과 해당 환경 변수는 브라우저 선택(chrome, firefox, webkit, msedge), 헤드리스 모드, 뷰포트 크기, 기기 에뮬레이션, 모바일 에뮬레이션, 프록시 설정, CDP 엔드포인트, 시간 제한, 콘솔 수준, test-id 속성, 권한, 출력 디렉터리, 시크릿 파일, 세션 저장, 스냅샷 모드 및 박스, 서비스 워커 차단, HTTPS 오류 처리, 샌드박스 토글 등을 다룹니다. --config로 JSON 구성 파일을 제공할 수도 있습니다. 사용자 프로필 처리는 작업공간 해시로 키가 지정된 플랫폼별 캐시 위치에 저장되는 영구 프로필, 닫을 때 저장 상태를 폐기하는 격리 세션, Playwright Chrome 확장 프로그램을 통한 기존 브라우저 연결을 지원합니다. 초기 상태는 사용자 데이터 디렉터리, 저장 상태 파일, Playwright 페이지 객체에서 평가되는 init-page TypeScript 파일, 또는 페이지 스크립트 전에 평가되는 init-script JavaScript 파일을 통해 제공할 수 있습니다.