@playwright/mcp 0.0.1 → 0.0.3

package/README.md

@@ -4,7 +4,7 @@ A Model Context Protocol (MCP) server that provides browser automation capabilit
 
 ### Key Features
 
-- **Fast and lightweight**: Uses Playwright’s accessibility tree, not pixel-based input.
+- **Fast and lightweight**: Uses Playwright's accessibility tree, not pixel-based input.
 - **LLM-friendly**: No vision models needed, operates purely on structured data.
 - **Deterministic tool application**: Avoids ambiguity common with screenshot-based approaches.
 
@@ -23,13 +23,31 @@ A Model Context Protocol (MCP) server that provides browser automation capabilit
     "playwright": {
       "command": "npx",
       "args": [
-        "@playwright/mcp",
+        "@playwright/mcp@latest"
       ]
     }
   }
 }
 ```
 
+
+#### Installation in VS Code
+
+Install the Playwright MCP server using the VS Code CLI:
+
+```bash
+# For VS Code
+code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
+```
+
+```bash
+# For VS Code Insiders
+code-insiders --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
+```
+
+After installation, the Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code.
+
+
 ### Running headless browser (Browser without GUI).
 
 This mode is useful for background or batch operations.
@@ -40,7 +58,7 @@ This mode is useful for background or batch operations.
     "playwright": {
       "command": "npx",
       "args": [
-        "@playwright/mcp",
+        "@playwright/mcp@latest",
         "--headless"
       ]
     }
@@ -66,7 +84,7 @@ And then in MCP config, add following to the `env`:
     "playwright": {
       "command": "npx",
       "args": [
-        "@playwright/mcp"
+        "@playwright/mcp@latest"
       ],
       "env": {
         // Use the endpoint from the output of the server above.
@@ -92,7 +110,7 @@ To use Vision Mode, add the `--vision` flag when starting the server:
     "playwright": {
       "command": "npx",
       "args": [
-        "@playwright/mcp",
+        "@playwright/mcp@latest",
         "--vision"
       ]
     }

package/lib/context.js

@@ -52,6 +52,7 @@ exports.Context = void 0;
 const playwright = __importStar(require("playwright"));
 class Context {
     _launchOptions;
+    _browser;
     _page;
     _console = [];
     _initializePromise;
@@ -69,29 +70,37 @@ class Context {
     async close() {
         const page = await this.ensurePage();
         await page.close();
-        this._initializePromise = undefined;
     }
     async _initialize() {
         if (this._initializePromise)
             return this._initializePromise;
         this._initializePromise = (async () => {
-            const browser = await this._createBrowser();
-            this._page = await browser.newPage();
+            this._browser = await createBrowser(this._launchOptions);
+            this._page = await this._browser.newPage();
             this._page.on('console', event => this._console.push(event));
             this._page.on('framenavigated', frame => {
                 if (!frame.parentFrame())
                     this._console.length = 0;
             });
+            this._page.on('close', () => this._reset());
         })();
         return this._initializePromise;
     }
-    async _createBrowser() {
-        if (process.env.PLAYWRIGHT_WS_ENDPOINT) {
-            const url = new URL(process.env.PLAYWRIGHT_WS_ENDPOINT);
-            url.searchParams.set('launch-options', JSON.stringify(this._launchOptions));
-            return await playwright.chromium.connect(String(url));
-        }
-        return await playwright.chromium.launch({ channel: 'chrome', ...this._launchOptions });
+    _reset() {
+        const browser = this._browser;
+        this._initializePromise = undefined;
+        this._browser = undefined;
+        this._page = undefined;
+        this._console.length = 0;
+        void browser?.close();
     }
 }
 exports.Context = Context;
+async function createBrowser(launchOptions) {
+    if (process.env.PLAYWRIGHT_WS_ENDPOINT) {
+        const url = new URL(process.env.PLAYWRIGHT_WS_ENDPOINT);
+        url.searchParams.set('launch-options', JSON.stringify(launchOptions));
+        return await playwright.chromium.connect(String(url));
+    }
+    return await playwright.chromium.launch({ channel: 'chrome', ...launchOptions });
+}

package/lib/server.js

@@ -23,7 +23,6 @@ const context_1 = require("./context");
 class Server {
     _server;
     _tools;
-    _page;
     _context;
     constructor(options, launchOptions) {
         const { name, version, tools, resources } = options;
@@ -74,7 +73,7 @@ class Server {
     }
     async stop() {
         await this._server.close();
-        await this._page?.context()?.browser()?.close();
+        await this._context.close();
     }
 }
 exports.Server = Server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playwright/mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Playwright Tools for MCP",
   "repository": {
     "type": "git",