剧作家mcp平行
](https://www.npmjs.com/package/playwright-mcp-parallel) 
添加并行增强功能 @剧作家/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"
]
}
}
}______________________________________________________________________
工具参考
🔌 连接和身份验证
| 工具 | 说明 |
|---|---|
browser_connect | 通过CDP连接到现有的Chrome并提取身份验证(Cookie+本地存储)。Chrome必须启动 --remote-debugging-port=9222. |
instance_export_auth | 从特定实例(或连接的Chrome)导出身份验证状态。更新全局身份验证,以便新实例将继承它 |
🖥️ 实例管理
| 工具 | 说明 |
|---|---|
instance_create | 创建一个新的隔离浏览器实例。可选择从连接的Chrome自动克隆身份验证。 |
instance_list | 列出所有活动实例及其当前URL和标题。 |
instance_close | 关闭特定实例并释放其资源。 |
instance_close_all | 立即关闭所有实例。 |
🌐 浏览器工具(所有原创@description/mcp工具)
所有工具来自 @playwright/mcp 可用a page_ 前缀并要求 instanceId 参数:
| 工具 | 说明 |
|---|---|
page_browser_navigate | 将实例导航到URL |
page_browser_click | 单击实例中的元素 |
page_browser_type | 在元素中键入文本 |
page_browser_screenshot | 截取实例的屏幕截图 |
page_browser_snapshot | 获取实例的可访问性快照 |
page_browser_evaluate | 在实例中执行JavaScript |
page_browser_wait_for | 等待实例中的条件 |
| ... | 所有其他 @playwright/mcp 工具与 page_ 前缀 |
______________________________________________________________________
用法示例
典型工作流程:身份验证克隆+并行任务
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]| 选项 | 描述 |
|---|---|
--headless | 在无头模式下运行浏览器 |
| `--browser | |
| ` | 要使用的浏览器: chrome, firefox, webkit, msedge |
--viewport-size | 视口大小,例如。 1280x720 |
| `--user-data-dir | |
| ` | 用户数据目录的路径 |
| `--storage-state | |
| ` | 存储状态JSON文件的路径 |
| `--proxy-server | |
| ` | 代理服务器,例如。 http://myproxy:3128 |
--no-sandbox | 禁用沙盒 |
| `--port | |
| ` | SSE运输港口 |
--isolated | 仅将浏览器配置文件保存在内存中 |
有关选项的完整列表,请参阅 @剧作家/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的区别
| 专题 | @剧作家/mcp | 剧作家-mcp平行 |
|---|---|---|
| 浏览器实例 | 1 | 无限制 |
| 并行执行 | ❌ | ✅ |
| 身份验证克隆 | ❌ | ✅ |
| 身份验证导出 | ❌ | ✅ |
| 原始工具 | ✅ | ✅ (通过 page_ 前缀) |
| 插入配置 | ✅ | ✅ |
______________________________________________________________________
需求
- Node.js>=18
- 任何兼容MCP的客户端(Claude Desktop、Cursor、VS Code、Windsurf等)
______________________________________________________________________
许可证
Apache-2.0——基于 @剧作家/mcp 微软。
