浏览器自动化服务

Playwright MCP Wrapper

Multi-tenant Playwright browser automation MCP server with Platform JWT authentication.

Features

• 🔐 Platform JWT authentication (no OAuth required)
• 🌐 Multi-tenant support (single server, multiple users)
• 🎭 Playwright browser automation
• 🔒 Isolated browser contexts per user
• ☁️ Cloud Run deployment ready
• 📊 Rate limiting and monitoring

Architecture

This is a static server - no per-user credentials needed:

• No OAuth flow
• No user account connection
• Just JWT authentication
• Available to all users immediately

Quick Start

Prerequisites

• Node.js >= 18.0.0
• npm or yarn
• Docker (for containerization)
• GCP account (for deployment)

Installation

# Clone repository
git clone <repository-url>
cd playwright-mcp-server

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your PLATFORM_SERVICE_TOKEN
nano .env

# Build
npm run build

# Run
npm start

Development

# Run in watch mode
npm run dev

Configuration

Environment Variables

API Usage

Authentication

All requests require a valid Platform JWT in the Authorization header:

curl -X POST http://localhost:8080/mcp/message \
  -H "Authorization: Bearer <jwt-token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Available Tools

• playwright_navigate - Navigate to URL
• playwright_screenshot - Capture screenshot
• playwright_click - Click element
• playwright_fill - Fill form field
• playwright_evaluate - Execute JavaScript
• playwright_pdf - Generate PDF

Deployment

Docker

# Build image
docker build -t playwright-mcp-wrapper .

# Run container
docker run -p 8080:8080 \
  -e PLATFORM_SERVICE_TOKEN=your-token \
  playwright-mcp-wrapper

Google Cloud Run

# Deploy
gcloud builds submit --config cloudbuild.yaml \
  --substitutions=_CORS_ORIGIN=https://agentbase.me,COMMIT_SHA=$(git rev-parse HEAD)

See DEPLOYMENT.md for detailed instructions.

Development

Project Structure

playwright-mcp-server/
├── src/
│   ├── index.ts                    # Main entry point
│   └── auth/
│       └── platform-jwt-provider.ts # JWT validation
├── agent/                          # ACP documentation
├── scripts/                        # Utility scripts
├── package.json
├── tsconfig.json
├── Dockerfile
└── cloudbuild.yaml

Scripts

• npm run build - Compile TypeScript
• npm run dev - Run in watch mode
• npm start - Run production build
• npm run script - Run TypeScript scripts

Security

• JWT validation on all requests
• CORS configuration
• Rate limiting (50 req/hour per user)
• Isolated browser contexts
• No persistent state

Monitoring

• Health check: GET /mcp/health
• Cloud Logging integration
• Cloud Monitoring metrics

License

MIT

Support

For issues and questions, please open an issue on GitHub.