The Playwright MCP server enables automated browser interactions through a Docker environment, supporting headless Chromium, Firefox, and WebKit browsers for various web automation tasks.
Navigate and interact: Visit URLs, navigate history, click elements, type text, select options, drag, hover, and upload files.
Manage browser tabs: Open, switch between, list, and close tabs.
Capture page data: Take screenshots, save PDFs, log network requests, and generate accessibility snapshots.
Handle dialogs: Accept or dismiss browser alerts, prompts, and confirms with custom input.
Wait and monitor: Wait for specific conditions or timeframes, and receive real-time updates via SSE.
Generate and debug: Automatically create Playwright test scripts, enable debugging logs, and save trace files.
Customize and integrate: Configure via environment variables and connect with tools like n8n, VS Code, and Cursor.
Enables browser automation for Firefox, allowing AI agents to interact with web pages through structured accessibility snapshots, perform navigation, clicks, typing, and other browsing actions.
Integrates with GitHub Copilot in VS Code, providing tools for web automation that allow the AI assistant to interact with websites, fill forms, click buttons, and extract data from web pages.
Provides browser automation capabilities built on Node.js, allowing programmatic control of web browsers for navigation, interaction, and data extraction from web pages.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Playwright MCPgo to github.com and search for 'playwright automation'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Playwright MCP Docker Environment
Docker環境でPlaywright MCPサーバーを実行し、外部ツールから自動ブラウザ操作を可能にするプロジェクトです。
🚀 クイックスタート
# 1. リポジトリをクローン
git clone <repository-url>
cd playwright-replan
# 2. Docker Composeで起動
docker-compose up -d
# 3. 動作確認
curl http://localhost:8931/healthSSEエンドポイント: http://localhost:8931/sse
Related MCP server: Playwright MCP Server
📋 機能
ヘッドレスブラウザ操作: Chromium/Firefox/WebKitでの自動操作
SSE通信: リアルタイムなブラウザ操作結果の取得
外部ツール連携: n8n、VS Code、Cursorなどとの統合
出力ファイル管理: スクリーンショット、PDF、Traceファイルの保存
設定可能: 環境変数による柔軟な設定変更
🛠️ 構成
playwright-replan/
├── Dockerfile # MCPサーバー用コンテナ
├── docker-compose.yml # サービス定義
├── .env # 環境設定
├── scripts/
│ ├── entrypoint.sh # 起動スクリプト
│ └── health-check.sh # ヘルスチェック
├── config/
│ └── mcp-server.json # MCP設定
├── output/ # 出力ファイル
└── docs/
├── SETUP.md # 詳細セットアップ
└── API_USAGE.md # API使用方法⚙️ 設定
環境変数
変数 | デフォルト | 説明 |
| 8931 | 公開ポート |
| - | デバッグログ有効化 |
| false | Trace保存 |
| false | スクリーンショットモード |
デバッグ有効化
echo "DEBUG=pw:api" >> .env
docker-compose restart🔗 外部ツール連携
n8n
{
"mcpServers": {
"playwright": {
"url": "http://localhost:8931/sse"
}
}
}VS Code/Cursor
{
"mcpServers": {
"playwright": {
"url": "http://localhost:8931/sse"
}
}
}📊 監視
# ログ確認
docker-compose logs -f
# ヘルスチェック
curl http://localhost:8931/health
# コンテナ状態
docker-compose ps📚 ドキュメント
🔧 トラブルシューティング
よくある問題
ポート競合:
.envでMCP_HOST_PORTを変更起動失敗:
docker-compose logsでエラー確認接続できない: ファイアウォール設定を確認
サポート
問題が発生した場合は、以下を確認してください：
コンテナログ:
docker-compose logs playwright-mcpヘルスチェック:
curl http://localhost:8931/health
📝 ライセンス
このプロジェクトは実験的なものです。商用利用の際は適切なライセンス確認を行ってください。
🤝 貢献
プルリクエストやイシューの報告を歓迎します。