@playwright-repl/mcp 0.14.0 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +6 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -36,7 +36,7 @@ Claude Desktop / Claude Code (or any MCP client)
36
36
  ↕ MCP (stdio)
37
37
  playwright-repl MCP server
38
38
  ↕ WebSocket bridge
39
- Chrome extension (panel page)
39
+ Chrome extension (offscreen document → service worker)
40
40
  ↕ CDP / chrome.debugger
41
41
  Playwright running in your real Chrome session
42
42
  ```
@@ -82,16 +82,17 @@ claude mcp add playwright-repl playwright-repl-mcp
82
82
 
83
83
  ### 4. Connect
84
84
 
85
- Open Chrome → click the **Dramaturg** icon to open the side panel. The extension connects to the MCP server automatically. You're ready.
85
+ The extension connects to the MCP server automatically — no need to open the side panel. Just make sure Chrome is running with the Dramaturg extension installed.
86
86
 
87
87
  ## Dramaturg — The Extension
88
88
 
89
- Dramaturg is the other half of the system — it's what gives the MCP server access to your real browser session. While the MCP server is running, the Dramaturg panel acts as the live bridge between AI commands and Chrome.
89
+ Dramaturg is the other half of the system — it's what gives the MCP server access to your real browser session.
90
90
 
91
91
  ### What the extension does
92
92
 
93
93
  - **Runs Playwright inside Chrome** — uses `playwright-crx` and `chrome.debugger` to execute commands directly in your existing session, no separate browser needed. Because Playwright runs inside the browser rather than relaying through an external process, the entire AI → command → result loop is faster.
94
- - **Connects automatically** — opens a WebSocket connection to the MCP server as soon as the side panel is visible; reconnects if the connection drops
94
+ - **Connects automatically** — a persistent offscreen document maintains the WebSocket connection to the MCP server; reconnects if the connection drops. No side panel needed.
95
+ - **Auto-attaches** — on the first command, automatically attaches to the active Chrome tab
95
96
  - **Executes commands** — receives `run_command` calls from the AI and runs them against the active tab
96
97
 
97
98
  ### Using the extension alongside AI
@@ -108,7 +109,7 @@ The extension panel is more than just a bridge — it's a full REPL you can use
108
109
 
109
110
  The extension connects to the MCP server on port `9876` by default. To check or change the port: extension icon → **Options** → **Bridge Port**. Changes take effect after reopening the panel.
110
111
 
111
- When the panel is open and connected, the MCP server logs `Extension connected` to stderr. When the panel is closed or Chrome is not open, `run_command` returns: `Browser not connected. Open Chrome with Dramaturg — it connects automatically.`
112
+ When the extension is connected, the MCP server logs `Extension connected` to stderr. When Chrome is not open or the extension is not installed, `run_command` returns: `Browser not connected. Open Chrome with Dramaturg — it connects automatically.`
112
113
 
113
114
  ## Tool: `run_command`
114
115
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@playwright-repl/mcp",
3
- "version": "0.14.0",
3
+ "version": "0.15.1",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "playwright-repl-mcp": "./dist/index.js"