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/health

SSEエンドポイント: http://localhost:8931/sse

📋 機能

• ヘッドレスブラウザ操作: 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使用方法

⚙️ 設定

環境変数

変数	デフォルト	説明
MCP_HOST_PORT	8931	公開ポート
DEBUG	-	デバッグログ有効化
SAVE_TRACE	false	Trace保存
VISION_MODE	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

📚 ドキュメント

• 詳細セットアップガイド
• API使用方法
• 開発者向けガイド

🔧 トラブルシューティング

よくある問題

1. ポート競合: .envでMCP_HOST_PORTを変更
2. 起動失敗: docker-compose logsでエラー確認
3. 接続できない: ファイアウォール設定を確認

サポート

問題が発生した場合は、以下を確認してください：

• トラブルシューティングガイド
• コンテナログ: docker-compose logs playwright-mcp
• ヘルスチェック: curl http://localhost:8931/health

📝 ライセンス

このプロジェクトは実験的なものです。商用利用の際は適切なライセンス確認を行ってください。

🤝 貢献

プルリクエストやイシューの報告を歓迎します。