Playwright MCP Server
Microsoft의 Playwright MCP를 참고하여 구현한 Model Context Protocol (MCP) 서버입니다. streamableHttp transport를 사용하여 웹 브라우저 자동화 기능을 제공합니다.
기능
이 서버는 다음과 같은 브라우저 자동화 도구들을 제공합니다:
browser_navigate: URL로 이동
browser_snapshot: 현재 페이지의 접근성 스냅샷 캡처
browser_click: 요소 클릭
browser_type: 텍스트 입력
browser_take_screenshot: 스크린샷 촬영
browser_close: 브라우저 종료
설치
npm install
사용법
StreamableHttp Transport (권장)
# 기본 포트 3000으로 실행
npm run dev -- --streamable-http
# 특정 포트로 실행
npm run dev -- --streamable-http --port=8080
서버가 시작되면 http://localhost:3000/mcp (또는 지정한 포트)에서 MCP 서버에 접근할 수 있습니다.
Stdio Transport
npm run dev
프로그래밍 방식 사용법
import { PlaywrightMCPServer } from './src/server.js';
const server = new PlaywrightMCPServer();
// StreamableHttp transport로 시작
await server.start('streamableHttp', 3000);
// 또는 stdio transport로 시작
await server.start('stdio');
MCP 클라이언트 연결
MCP 클라이언트에서 이 서버에 연결하려면:
{
"mcpServers": {
"playwright": {
"command": "node",
"args": ["dist/index.js", "--streamable-http", "--port=3000"],
"env": {}
}
}
}
개발
# TypeScript 컴파일
npm run build
# 개발 모드 실행
npm run dev
# 프로덕션 빌드 후 실행
npm run build
npm start
라이선스
MIT
