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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables web browser automation through Playwright, providing tools for navigation, element interaction, screenshot capture, and accessibility snapshots. Uses streamableHttp transport for seamless integration with MCP clients.