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