Playwright MCP Parallel

剧作家mcp平行

添加并行增强功能 @剧作家/mcp\ 同时运行多个独立的浏览器实例，每个实例都有自己的上下文、身份验证和状态。

______________________________________________________________________

为什么剧作家mcp平行？

标准 @playwright/mcp 仅支持 一个浏览器实例 每台服务器。此软件包将其扩展为支持 N个并行实例，启用：

• 🔀 并行任务执行 --同时运行多个浏览器任务
• 🔐 身份克隆 --将Cookie/本地存储从您登录的Chrome克隆到所有新实例
• 🧩 孤立的环境 --每个实例都有完全独立的状态
• 🔌 插入兼容 --全部原创 @playwright/mcp 工具可通过 page_* 前缀

______________________________________________________________________

安装和设置

克劳德桌面/光标/VS代码/任何MCP客户端

{
  "mcpServers": {
    "playwright-parallel": {
      "command": "npx",
      "args": [
        "playwright-mcp-parallel@latest"
      ]
    }
  }
}

带选项（无头等）

{
  "mcpServers": {
    "playwright-parallel": {
      "command": "npx",
      "args": [
        "playwright-mcp-parallel@latest",
        "--headless"
      ]
    }
  }
}

______________________________________________________________________

工具参考

🔌 连接和身份验证

🖥️ 实例管理

🌐 浏览器工具（所有原创@description/mcp工具）

所有工具来自 @playwright/mcp 可用a page_ 前缀并要求 instanceId 参数：

______________________________________________________________________

用法示例

典型工作流程：身份验证克隆+并行任务

1. Start Chrome with debugging:
   chrome.exe --remote-debugging-port=9222

2. Log in manually in Chrome

3. In your AI agent:
   → browser_connect()                          # Extract auth from Chrome
   → instance_create({ instanceId: "task-1", url: "https://app.example.com" })
   → instance_create({ instanceId: "task-2", url: "https://app.example.com" })
   → (Both instances are logged in automatically!)

4. Run tasks in parallel:
   → page_browser_click({ instanceId: "task-1", ... })
   → page_browser_click({ instanceId: "task-2", ... })

5. Export auth from a running instance (e.g., after login flow):
   → instance_export_auth({ instanceId: "task-1" })
   → instance_create({ instanceId: "task-3" })  # Also logged in

从实例导出身份验证

→ instance_create({ instanceId: "login-bot", url: "https://example.com/login" })
→ page_browser_click({ instanceId: "login-bot", ... })   # complete login
→ instance_export_auth({ instanceId: "login-bot" })      # export & set as global auth
→ instance_create({ instanceId: "worker-1" })            # inherits login state
→ instance_create({ instanceId: "worker-2" })            # inherits login state

______________________________________________________________________

CLI选项

全部 @playwright/mcp 支持CLI选项：

npx playwright-mcp-parallel@latest [options]

有关选项的完整列表，请参阅 @剧作家/mcp文档.

______________________________________________________________________

运作原理

playwright-mcp-parallel
├── Management Layer
│   ├── browser_connect      → Extract auth from existing Chrome
│   ├── instance_create      → Launch isolated browser + clone auth
│   ├── instance_list        → List active instances
│   ├── instance_close       → Dispose instance
│   ├── instance_close_all   → Dispose all
│   └── instance_export_auth → Export cookies/localStorage from instance
│
└── Per-Instance Tool Dispatch
    └── page_* tools → routed to the correct BrowserBackend by instanceId

每 instance_create 呼叫启动a 铬新工艺 在一个孤立的背景下。通过以下方式提取身份验证状态（Cookie+本地存储） browser_connect 或 instance_export_auth 被自动注入到新的上下文中。

______________________________________________________________________

与@scription/mcp的区别

______________________________________________________________________

需求

• Node.js>=18
• 任何兼容MCP的客户端（Claude Desktop、Cursor、VS Code、Windsurf等）

______________________________________________________________________

许可证

Apache-2.0——基于 @剧作家/mcp 微软。