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