Playwright Universal MCP

🚀 Playwright Universal MCP 日本語版

これは、ブラウザ自動化用の汎用的なモデルコンテキストプロトコル（MCP）サーバーで、コンテナ化環境の制限付き権限下でも安定して動作します。ClaudeやGPT - 4などのAIアシスタントにブラウザ制御機能を提供します。

✨ 主な機能

• 🌐 多ブラウザ対応：Chromium、Chrome、Microsoft Edge、Firefox、WebKitを選択できます。
• 🐳 コンテナに適している：Dockerなどの制限付き環境でも使用可能です。
• 👁️ ヘッドレス/ヘッドフルモード：サーバーではヘッドレスモード、デバッグ時にはヘッドフルモードを使用できます。
• 🛠️ 全面的なブラウザ制御：ナビゲート、クリック、入力、スクリーンショットなどの機能を提供します。
• 📄 多ページ対応：複数のブラウザタブを作成し管理できます。

📦 インストール

選択肢1：pipxを使用したインストール（推奨）

# MCPサーバーをグローバルにインストール
pipx install playwright-universal-mcp

# 必要なブラウザをインストール
playwright install chromium
# オプション：他のブラウザをインストール
playwright install firefox webkit msedge chrome

選択肢2：仮想環境を使用したインストール

# 仮想環境を作成してアクティブ化
python -m venv playwright-mcp-venv
source playwright-mcp-venv/bin/activate

# パッケージをインストール
pip install playwright-universal-mcp

# ブラウザをインストール
playwright install chromium

選択肢3：ソースコードからのインストール

# リポジトリをクローン
git clone https://github.com/yourusername/playwright-universal-mcp.git
cd playwright-universal-mcp

# パッケージをインストール
pip install -e .

# ブラウザをインストール
playwright install chromium

💻 使用例

コマンドラインオプション

playwright-universal-mcp --help

ヘルプ情報を表示します：

使用方法：playwright-universal-mcp [オプション]
一般的なオプション：
  --version   バージョン番号を表示して終了
  -h, --help  このヘルプ情報を表示して終了

MCP設定

Claude Desktop設定

Claudeのsettings.jsonに以下の内容を追加し、MCPサーバーのアドレスを指定します：

{
  "mcp": {
    "serverUrl": "http://localhost:1234"
  }
}

その他のアプリケーション設定

具体的なアプリケーションのドキュメントに従って設定してください。

コンテナ化での使用

# ベースイメージを使用
FROM python:3.8

# 依存関係をインストール
RUN pip install playwright-universal-mcp

# 必要なブラウザをインストール
RUN playwright install chromium

# サーバーを起動
ENTRYPOINT ["playwright-universal-mcp", "--headless"]

ブラウザツールセット

MCPサーバーは以下の機能を提供します：

• navigate：指定されたURLにナビゲートします。
• click：セレクタまたはテキストで要素をクリックします。
• type：入力ボックスに文字を入力します。
• get_text：要素のテキスト内容を取得します。
• get_page_content：現在のページのHTML内容を取得します。
• take_screenshot：現在のページのスクリーンショットを撮ります。
• new_page：新しいブラウザタブを作成します。
• switch_page：指定されたタブに切り替えます。
• get_pages：利用可能なすべてのタブをリストします。
• wait_for_selector：要素が表示されるまで待機します。
• get_browser_info：ブラウザセッションの情報を取得します。

📄 ライセンス

MIT License

謝辞

このプロジェクトは以下に基づいています：

• Playwright が提供するブラウザ自動化機能
• モデルコンテキストプロトコル（MCP） の接続標準
• MCP Python SDK が提供するMCP実装