Browserplex

🚀 Browserplex

Browserplex 是一個用於管理多個命名瀏覽器會話的 MCP 服務器。標準的 Playwright MCP 服務器不支持多個併發用戶，當多個 AI 代理試圖同時使用它時，它們會在單個瀏覽器實例上產生衝突。而 Browserplex 通過提供命名會話解決了這一問題，允許每個代理管理自己獨立的瀏覽器會話。它基於 Playwright 構建，支持 Chromium、Firefox、WebKit（Safari）和 Camoufox（隱身 Firefox）等瀏覽器。

🚀 快速開始

Browserplex 提供了便捷的方式來管理多個瀏覽器會話，你可以通過以下步驟快速上手。

📦 安裝指南

npm install
npm run build

💻 使用示例

基礎用法

通過 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"

📚 詳細文檔

瀏覽器類型

工具說明

會話管理

導航操作

交互操作

實用工具

✨ 主要特性

• 多併發會話 - 可同時運行不同的瀏覽器。
• 命名會話 - 在工具調用中通過名稱引用會話。
• 自動調整截圖大小 - 圖像會自動調整大小以適應大語言模型的上下文限制。
• 結構化快照 - 包含語義標記（標題、鏈接、按鈕）的頁面內容。
• 控制檯/網絡捕獲 - 通過捕獲的控制檯消息和網絡請求進行調試。
• 標籤頁管理 - 每個會話可處理多個標籤頁。
• 優雅清理 - 服務器關閉時會話會自動關閉。

🔧 技術細節

開發命令

npm run build      # 編譯 TypeScript
npm test           # 運行測試
npm run test:watch # 監聽模式

📄 許可證

本項目採用 MIT 許可證。