Browserplex

🚀 browserplex

標準のPlaywright MCPサーバーは複数の同時ユーザーをサポートしていません。複数のAIエージェントが同時に使用しようとすると、単一のブラウザインスタンスをめぐって競合が発生します。Browserplexは名前付きセッションを提供することでこの問題を解決し、各エージェントが独自の分離されたブラウザセッションを管理できるようにします。

複数の名前付きブラウザセッションを管理するためのMCPサーバーです。Playwrightをベースに構築され、Chromium、Firefox、WebKit（Safari）、Camoufox（ステルスFirefox）をサポートしています。

🚀 クイックスタート

📦 インストール

npm install
npm run build

💻 使用例

基本的な使用法

Via npx

{
  "mcpServers": {
    "browserplex": {
      "type": "stdio",
      "command": "npx",
      "args": ["browserplex"]
    }
  }
}

高度な使用法

ローカル開発

{
  "mcpServers": {
    "browserplex": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/browserplex/dist/index.js"]
    }
  }
}

📚 ドキュメント

ブラウザの種類

ツール

セッション管理

ナビゲーション

インタラクション

ユーティリティ

具体的な使用例

# ヘッド付きのWebKit（Safari）セッションを作成する
session_create name="safari" type="webkit" headless=false

# ページに移動する
browser_navigate session="safari" url="https://example.com"

# ページのコンテンツを取得する
browser_snapshot session="safari"

# スクリーンショットを撮る
browser_take_screenshot session="safari"

# フォームを入力する
browser_fill_form session="safari" fields=[{selector: "#email", value: "test@example.com"}, {selector: "#password", value: "secret"}]

# ボタンをクリックする
browser_click session="safari" selector="button.submit"

# コンソールのエラーを確認する
browser_console_messages session="safari"

# クリーンアップする
session_destroy name="safari"

✨ 主な機能

• 複数の同時セッション - 異なるブラウザを並行して実行できます。
• 名前付きセッション - ツール呼び出し全体でセッションを名前で参照できます。
• 自動リサイズスクリーンショット - 画像はLLMコンテキストの制限に合わせて自動的にサイズ調整されます。
• 構造化されたスナップショット - セマンティックマークアップ（見出し、リンク、ボタン）付きのページコンテンツ。
• コンソール/ネットワークキャプチャ - キャプチャされたコンソールメッセージとネットワークリクエストでデバッグできます。
• タブ管理 - セッションごとに複数のタブで作業できます。
• 適切なクリーンアップ - サーバーシャットダウン時にセッションが自動的に閉じられます。

🔧 開発

npm run build      # TypeScriptをコンパイルする
npm test           # テストを実行する
npm run test:watch # ウォッチモード

📄 ライセンス

MIT