Patchright Lite MCP 서버
Patchright Node.js SDK를 래핑하여 AI 모델에 은밀한 브라우저 자동화 기능을 제공하는 간소화된 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 가벼운 서버는 간단한 AI 모델의 사용을 용이하게 하는 필수 기능에 중점을 둡니다.
Patchright란 무엇인가요?
Patchright는 Playwright 테스트 및 자동화 프레임워크의 탐지되지 않는 버전입니다. Playwright를 즉시 대체하도록 설계되었지만, 안티 봇 시스템의 탐지를 피할 수 있는 고급 스텔스 기능을 갖추고 있습니다. Patchright는 다음을 포함한 다양한 탐지 기술을 패치합니다.
- 런타임.enable 누수
- Console.enable 누수
- 명령 플래그 누출
- 일반 감지 지점
- 닫힌 Shadow Root 상호 작용
이 MCP 서버는 Patchright의 Node.js 버전을 래핑하여 간단하고 표준화된 프로토콜을 통해 AI 모델에서 해당 기능을 사용할 수 있도록 합니다.
특징
- 간단한 인터페이스 : 4가지 필수 도구만으로 핵심 기능에 집중
- 스텔스 자동화 : Patchright의 스텔스 모드를 사용하여 감지를 방지합니다.
- MCP 표준 : AI 통합을 용이하게 하기 위한 모델 컨텍스트 프로토콜 구현
- Stdio Transport : 원활한 통합을 위해 표준 입력/출력을 사용합니다.
필수 조건
설치
- 이 저장소를 복제하세요:지엑스피1
- 종속성 설치:
- TypeScript 코드를 작성합니다.
용법
다음을 사용하여 서버를 실행합니다.
이렇게 하면 stdio 전송으로 서버가 시작되어 MCP를 지원하는 AI 도구와 통합할 준비가 됩니다.
AI 모델과 통합
클로드 데스크탑
claude-desktop-config.json 파일에 다음을 추가하세요.
{
"mcpServers": {
"patchright": {
"command": "node",
"args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
}
}
}
GitHub Copilot을 사용한 VS 코드
VS Code CLI를 사용하여 MCP 서버를 추가합니다.
code --add-mcp '{"name":"patchright","command":"node","args":["path/to/patchright-lite-mcp-server/dist/index.js"]}'
사용 가능한 도구
서버는 4가지 필수 도구만 제공합니다.
1. 찾아보기
브라우저를 실행하고 URL로 이동하여 콘텐츠를 추출합니다.
Tool: browse
Parameters: {
"url": "https://example.com",
"headless": true,
"waitFor": 1000
}
보고:
- 페이지 제목
- 보이는 텍스트 미리보기
- 브라우저 ID(후속 작업용)
- 페이지 ID(후속 작업용)
- 스크린샷 경로
2. 상호 작용하다
페이지에서 간단한 상호작용을 수행합니다.
Tool: interact
Parameters: {
"browserId": "browser-id-from-browse",
"pageId": "page-id-from-browse",
"action": "click", // can be "click", "fill", or "select"
"selector": "#submit-button",
"value": "Hello World" // only needed for fill and select
}
보고:
3. 추출하다
현재 페이지에서 특정 콘텐츠를 추출합니다.
Tool: extract
Parameters: {
"browserId": "browser-id-from-browse",
"pageId": "page-id-from-browse",
"type": "text" // can be "text", "html", or "screenshot"
}
보고:
4. 닫다
리소스를 확보하기 위해 브라우저를 닫습니다.
Tool: close
Parameters: {
"browserId": "browser-id-from-browse"
}
사용 흐름 예시
- 브라우저를 실행하고 사이트로 이동합니다.
Tool: browse
Parameters: {
"url": "https://example.com/login",
"headless": false
}
- 로그인 양식을 작성하세요:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "fill",
"selector": "#username",
"value": "user@example.com"
}
- 비밀번호를 입력하세요:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "fill",
"selector": "#password",
"value": "password123"
}
- 로그인 버튼을 클릭하세요:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "click",
"selector": "#login-button"
}
- 로그인 확인을 위한 텍스트 추출:
Tool: extract
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"type": "text"
}
- 브라우저를 닫습니다:
Tool: close
Parameters: {
"browserId": "browser-id-from-step-1"
}
보안 고려 사항
- 이 서버는 강력한 자동화 기능을 제공합니다. 책임감 있고 윤리적으로 사용하세요.
- 웹사이트의 서비스 약관을 위반하는 작업은 자동화하지 마세요.
- 속도 제한을 염두에 두고 웹사이트에 과도한 요청을 보내지 마세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
감사의 말
- Kaliiiiiiiii-Vinyzu의 Patchright-nodejs
- modelcontextprotocol의 모델 컨텍스트 프로토콜
Docker 사용법
Docker를 사용하여 이 서버를 실행할 수 있습니다.
docker run -it --rm dylangroos/patchright-mcp
Docker 이미지를 로컬로 빌드하기
Docker 이미지를 빌드합니다.
docker build -t patchright-mcp .
컨테이너를 실행합니다.
docker run -it --rm patchright-mcp
도커 허브
변경 사항이 메인 브랜치에 병합되면 이미지가 Docker Hub에 자동으로 게시됩니다. 최신 이미지는 dylangroos/patchright-mcp 에서 확인할 수 있습니다.