Playwright Universal MCP

Playwright Universal MCP

権限が限られたコンテナ化環境でも安定して動作する、ブラウザー自動化向けの汎用 Model Context Protocol (MCP) サーバーです。Claude、GPT-4 などの AI アシスタントにブラウザー制御機能を提供します。

機能

• 🌐 複数ブラウザーのサポート：Chromium、Chrome、Microsoft Edge、Firefox、WebKit から選択できます
• 🐳 コンテナに適した設計：Docker コンテナのような、権限が限られた環境で動作します
• 👁️ ヘッドレス／ヘッドフルモード：サーバー環境ではヘッドレスモード、デバッグ時にはヘッドフルモードで実行できます
• 🛠️ 幅広いブラウザー制御：移動、クリック、入力、スクリーンショットの撮影などができます
• 📄 複数ページのサポート：複数のブラウザーページ／タブを作成、管理できます

インストール

オプション 1：pipx でインストール（推奨）

# Install the MCP Python SDK
pip install git+https://github.com/microsoft/mcp-python-sdk.git

# Install the MCP server globally
pipx install playwright-universal-mcp

# Install the required browsers
playwright install chromium
# Optional: install other browsers
playwright install firefox webkit msedge chrome

オプション 2：Python 仮想環境にインストール

# Create and activate a virtual environment
python -m venv playwright-mcp-venv
source playwright-mcp-venv/bin/activate

# Install the MCP Python SDK
pip install git+https://github.com/microsoft/mcp-python-sdk.git

# Install the package
pip install playwright-universal-mcp

# Install browsers
playwright install chromium

オプション 3：ソースからインストール

# Clone the repository
git clone https://github.com/xkiranj/playwright-universal-mcp.git
cd playwright-universal-mcp

# Install the MCP Python SDK
pip install git+https://github.com/microsoft/mcp-python-sdk.git

# Install the package
pip install -e .

# Install browsers
playwright install chromium

使用方法

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

playwright-universal-mcp --help

usage: playwright-universal-mcp [-h] [--browser {chromium,firefox,webkit,msedge,chrome}] [--headless] [--headful] [--debug] [--browser-arg BROWSER_ARG]

Universal Playwright MCP server with multi-browser support

options:
  -h, --help            show this help message and exit
  --browser {chromium,firefox,webkit,msedge,chrome}, -b {chromium,firefox,webkit,msedge,chrome}
                        Browser to use (default: chromium)
  --headless            Run browser in headless mode (default: true)
  --headful             Run browser in headful mode (with GUI)
  --debug               Enable debug logging
  --browser-arg BROWSER_ARG
                        Additional browser arguments (can be specified multiple times)

基本的な例

# Start with default options (Chromium in headless mode)
playwright-universal-mcp

# Use Microsoft Edge
playwright-universal-mcp --browser msedge

# Use Firefox in headful mode (visible browser window)
playwright-universal-mcp --browser firefox --headful

# Enable debug logging
playwright-universal-mcp --debug

# Pass additional arguments to the browser
playwright-universal-mcp --browser-arg="--disable-gpu" --browser-arg="--window-size=1920,1080"

MCP の設定

この MCP サーバーを Claude Desktop やその他の MCP 対応アプリケーションで使用するには、次の設定を追加します。

Claude Desktop の設定

~/.config/Claude/claude_desktop_config.json ファイルに次の内容を追加します。

{
  "mcpServers": {
    "browser": {
      "command": "playwright-universal-mcp",
      "args": ["--browser", "msedge", "--headless"]
    }
  }
}

PM2 サービスとして実行

MCP サーバーを PM2 で常駐サービスとして実行するには、次の手順に従います。

1. PM2 設定ファイルを作成します。

cat > ~/playwright-universal-mcp.config.js << 'EOF'
module.exports = {
  apps: [{
    name: "playwright-universal-mcp",
    script: "playwright-universal-mcp",
    args: "--browser msedge --headless",
    watch: false,
    autorestart: true,
    restart_delay: 3000
  }]
}
EOF

2. サービスを起動します。

pm2 start ~/playwright-universal-mcp.config.js

3. PM2 のプロセスリストを保存します。

pm2 save

コンテナ環境での使用

この MCP サーバーはコンテナ化環境で適切に動作します。以下にシンプルな Dockerfile の例を示します。

FROM python:3.10-slim

# Install dependencies
RUN apt-get update && apt-get install -y \
    wget \
    gnupg \
    && rm -rf /var/lib/apt/lists/*

# Install the package
RUN pip install playwright-universal-mcp

# Install browsers (install the ones you need)
RUN playwright install chromium

# Run the MCP server
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
• 接続規格のための Model Context Protocol (MCP)
• MCP の実装のための MCP Python SDK