Browserplex

🚀 Browserplex

Browserplex is an MCP server for managing multiple named browser sessions. It addresses the issue that the standard Playwright MCP server doesn't support multiple concurrent users. By providing named sessions, it allows each agent to manage its own isolated browser session.

🚀 Quick Start

Browserplex is a server built on Playwright, supporting Chromium, Firefox, WebKit (Safari), and Camoufox (stealth Firefox). It enables multiple concurrent users to have their own isolated browser sessions.

✨ Features

• Multiple concurrent sessions - Run different browsers side-by-side
• Named sessions - Reference sessions by name across tool calls
• Auto-resize screenshots - Images automatically sized for LLM context limits
• Structured snapshots - Page content with semantic markup (headings, links, buttons)
• Console/network capture - Debug with captured console messages and network requests
• Tab management - Work with multiple tabs per session
• Graceful cleanup - Sessions automatically closed on server shutdown

📦 Installation

npm install
npm run build

💻 Usage Examples

Via npx

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

Local development

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

Basic Usage

# Create a headed WebKit (Safari) session
session_create name="safari" type="webkit" headless=false

# Navigate to a page
browser_navigate session="safari" url="https://example.com"

# Get page content
browser_snapshot session="safari"

# Take a screenshot
browser_take_screenshot session="safari"

# Fill a form
browser_fill_form session="safari" fields=[{selector: "#email", value: "test@example.com"}, {selector: "#password", value: "secret"}]

# Click a button
browser_click session="safari" selector="button.submit"

# Check console for errors
browser_console_messages session="safari"

# Clean up
session_destroy name="safari"

📚 Documentation

Browser Types

Tools

Session Management

Navigation

Interaction

Utilities

🔧 Technical Details

npm run build      # Compile TypeScript
npm test           # Run tests
npm run test:watch # Watch mode

📄 License

MIT