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 许可证。