웹페이지에 GUI 에이전트를 삽입해 사용자가 자연어로 인터페이스를 제어할 수 있게 하는 JavaScript 라이브러리입니다.
microsoft/playwright-mcp
구조화된 접근성 스냅샷을 통해 LLM 클라이언트가 Playwright로 실제 브라우저를 제어하도록 하는 Model Context Protocol 서버입니다.
- 스타
- 38,397
- 포크
- 3,288
- 열린 이슈
- 0
- 마지막 커밋
- 22시간 전
어떤 프로젝트인가요?
Playwright MCP는 Playwright 기반 브라우저 자동화 기능을 LLM 클라이언트에 제공하는 Model Context Protocol 서버입니다. 비전 모델에 스크린샷을 보내는 대신 페이지를 구조화된 접근성 스냅샷으로 노출하므로, 모델은 스냅샷의 참조나 고유 선택자를 사용해 요소를 조작합니다.
이 서버는 VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Codex, Copilot 등의 MCP 클라이언트에서 사용할 수 있으며, npx로 실행하거나 Docker 컨테이너로 구동할 수 있습니다. 브라우저 세션은 영구 프로필, 격리된 인메모리 컨텍스트를 사용하거나 브라우저 확장 프로그램을 통해 기존 Chrome 또는 Edge 인스턴스에 연결할 수 있습니다. 옵션으로 브라우저, 뷰포트, 프록시, 허용 및 차단할 origin 목록, 출력 디렉터리, 스냅샷 형식을 설정할 수 있습니다.
도구 모음은 클릭, 입력, 드래그 앤 드롭, 파일 업로드, 폼 작성, JavaScript 평가, 콘솔 메시지, 미디어 에뮬레이션, 페이지 내 검색을 지원합니다. 선택 기능을 추가하면 비전 기반 좌표 조작, PDF 처리, DevTools 기능도 사용할 수 있습니다. 프로젝트는 이 도구가 보안 경계가 아님을 명시합니다.
핵심 기능
- 01스크린샷 대신 Playwright 접근성 스냅샷을 사용하므로 비전 모델이 필요하지 않습니다.
- 02VS Code, Cursor, Claude Desktop, Codex를 비롯한 다양한 MCP 클라이언트에서 사용할 수 있습니다.
- 03영구 세션, 격리 세션, 기존 브라우저에 확장 프로그램으로 연결하는 세션을 지원합니다.
- 04클릭, 폼 작성, 파일 업로드, 드래그 앤 드롭, JavaScript 평가 도구를 제공합니다.
- 05브라우저, 네트워크, 출력 설정을 위한 JSON 설정 파일과 다양한 CLI 옵션을 제공합니다.
활용 사례
- AI 코딩 에이전트가 웹 앱을 열어 상태를 확인하고 변경 사항을 검증하도록 합니다.
- LLM 기반 탐색적 테스트나 자동 복구 테스트 워크플로를 실행합니다.
- 영구 브라우저 프로필이나 연결된 브라우저 프로필로 로그인 상태가 필요한 작업을 자동화합니다.
- Docker 컨테이너 안에서 에이전트용 헤드리스 브라우저 자동화를 실행합니다.
빠른 시작
- 1
MCP 클라이언트에 표준 설정을 추가합니다(npx를 통해 실행).
npx @playwright/mcp@latest - 2
Claude Code로 Playwright MCP 서버를 설치합니다.
claude mcp add playwright npx @playwright/mcp@latest
사용 전 알아둘 점
- Node.js 18 이상이 필요합니다.
- MCP 클라이언트용으로 설계되어 있어, 사용하려면 MCP 호환 도구가 필요합니다.
- README에 따르면, 스킬이 포함된 CLI가 코딩 에이전트에서 토큰을 더 효율적으로 사용할 수 있습니다.
토픽
자주 묻는 질문
- playwright-mcp은(는) 무엇인가요?
- 구조화된 접근성 스냅샷을 통해 LLM 클라이언트가 Playwright로 실제 브라우저를 제어하도록 하는 Model Context Protocol 서버입니다. Playwright MCP는 Playwright 기반 브라우저 자동화 기능을 LLM 클라이언트에 제공하는 Model Context Protocol 서버입니다. 비전 모델에 스크린샷을 보내는 대신 페이지를 구조화된 접근성 스냅샷으로 노출하므로, 모델은 스냅샷의 참조나 고유 선택자를 사용해 요소를 조작합니다.
- playwright-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- playwright-mcp은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- playwright-mcp은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. playwright-mcp의 마지막 커밋은 2026년 10월 19일입니다.
- playwright-mcp은(는) 어디에 사용할 수 있나요?
- AI 코딩 에이전트가 웹 앱을 열어 상태를 확인하고 변경 사항을 검증하도록 합니다. LLM 기반 탐색적 테스트나 자동 복구 테스트 워크플로를 실행합니다. 영구 브라우저 프로필이나 연결된 브라우저 프로필로 로그인 상태가 필요한 작업을 자동화합니다. Docker 컨테이너 안에서 에이전트용 헤드리스 브라우저 자동화를 실행합니다.
- playwright-mcp는 어떻게 설치하나요?
- MCP 클라이언트에 표준 설정을 추가합니다(npx를 통해 실행).: npx @playwright/mcp@latest Claude Code로 Playwright MCP 서버를 설치합니다.: claude mcp add playwright npx @playwright/mcp@latest
- playwright-mcp은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/microsoft/playwright-mcp
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 에이전트가 실제 작업을 수행하도록 Docker 기반 Linux 데스크톱, 브라우저, 문서 도구를 제공하는 오픈 에이전트 프레임워크
AI 에이전트를 위해 만든 오픈소스 Chromium 기반 브라우저로, 로컬에서 실행되며 로그인된 계정을 사용해 여러 탭에서 에이전트를 병렬로 작업하게 합니다.
AI 에이전트가 스냅샷, 요소 참조, 일반적인 자동화 명령으로 Chrome을 제어할 수 있게 해주는 네이티브 Rust CLI입니다.
ByteDance의 오픈소스 멀티모달 AI 에이전트 스택으로, CLI/Web UI(Agent TARS)와 데스크톱 GUI 에이전트 앱(UI-TARS Desktop)을 제공합니다.
에이전트, 컴퓨터 사용, 브라우저 자동화, 금융 분석을 다루는 Claude API 기반 애플리케이션 스타터 프로젝트 모음