극작가-MCP

MCP(Model Context Protocol)용 Playwright 래퍼입니다. 이 서버는 LLM 기반 클라이언트가 자동화 작업을 위해 브라우저를 제어할 수 있도록 지원합니다.

구성 요소

자원

서버는 브라우저 스크린샷에 액세스하기 위한 리소스를 제공합니다.

스크린샷 리소스 URI: screenshot://{page_id}
모든 열려 있는 페이지에서 스크린샷 리소스를 자동으로 사용할 수 있습니다.

프롬프트

서버는 클라이언트가 웹 페이지를 해석하는 데 도움이 되는 프롬프트를 제공합니다.

interpret-page : 현재 웹 페이지의 내용과 구조를 분석합니다.
- 해석할 페이지를 선택하기 위한 선택적 page_id 인수
- 특정 측면(전체, 양식, 탐색, 텍스트)에 초점을 맞추기 위한 선택적 focus 인수
- 텍스트 분석과 페이지 스크린샷을 모두 반환합니다.

도구

서버는 포괄적인 브라우저 자동화 도구 세트를 구현합니다.

브라우저 탐색
- navigate : 특정 URL로 이동
- new_page : 특정 ID로 새로운 브라우저 페이지를 만듭니다.
- switch_page : 다른 브라우저 페이지로 전환
- get_pages : 사용 가능한 모든 브라우저 페이지 나열
페이지 상호작용
- click : CSS 선택기를 사용하여 요소를 클릭합니다.
- type : 입력 요소에 텍스트를 입력합니다.
- wait_for_selector : 페이지에 요소가 나타날 때까지 기다립니다.
콘텐츠 추출
- get_text : 요소에서 텍스트 콘텐츠를 가져옵니다.
- get_page_content : 전체 페이지 HTML 가져오기
- take_screenshot : 페이지 또는 요소의 시각적 상태를 캡처합니다.

구성

종속성 설치

지엑스피1

빠른 시작

설치하다

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "playwright-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/shannon/Workspace/artivus/playwright-mcp",
      "run",
      "playwright-mcp"
    ]
  }
}

"mcpServers": {
  "playwright-mcp": {
    "command": "uvx",
    "args": [
      "playwright-mcp"
    ]
  }
}

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

종속성 동기화 및 잠금 파일 업데이트:

uv sync

패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

토큰: --token 또는 UV_PUBLISH_TOKEN
또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory /Users/shannon/Workspace/artivus/playwright-mcp run playwright-mcp

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.