playwright-repl 0.1.1 → 0.2.0

package/{RELEASES.md → CHANGELOG.md}

@@ -1,4 +1,30 @@
-# Releases
+# Changelog
+
+## v0.2.0 — MCP Server
+
+**2026-02-16**
+
+### Features
+
+- **MCP Server**: Ships a stdio MCP server (`playwright-mcp-server`) that exposes Playwright's full browser automation toolkit to AI agents (Claude, Cursor, etc.)
+- Supports `--headed` flag for visible browser mode
+
+### Configuration
+
+VS Code / Cursor — add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-p", "playwright-repl", "playwright-mcp-server", "--headed"]
+    }
+  }
+}
+```
+
+---
 
 ## v0.1.1 — Bug Fixes
 

package/README.md

@@ -1,5 +1,7 @@
 # playwright-repl
 
+![playwright-repl](cover-image.png)
+
 Interactive REPL for Playwright browser automation — keyword-driven testing from your terminal.
 
 Inspired by [playwright-cli](https://github.com/anthropics/playwright-cli), reusing its command vocabulary and Playwright MCP daemon. Where playwright-cli is designed for AI agents (one command per process), playwright-repl is designed for **humans** — a persistent session with recording, replay, and instant feedback.
@@ -128,6 +130,52 @@ playwright-repl --session checkout-flow --headed
 | `-q, --silent` | Suppress banner and status messages |
 | `-h, --help` | Show help |
 
+## MCP Server
+
+`playwright-repl` also ships an MCP server that exposes Playwright's full browser automation toolkit to AI agents (Claude, Cursor, etc.) over stdio.
+
+```bash
+# Run directly
+npx -p playwright-repl playwright-mcp-server
+
+# With visible browser
+npx -p playwright-repl playwright-mcp-server --headed
+```
+
+### VS Code / Cursor Configuration
+
+Add to `.vscode/mcp.json` in your project:
+
+```json
+{
+  "servers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-p", "playwright-repl", "playwright-mcp-server"]
+    }
+  }
+}
+```
+
+Or with a visible browser:
+
+```json
+{
+  "servers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-p", "playwright-repl", "playwright-mcp-server", "--headed"]
+    }
+  }
+}
+```
+
+### MCP Server Options
+
+| Option | Description |
+|--------|-------------|
+| `--headed` | Run browser in headed (visible) mode |
+
 ## Commands
 
 ### Navigation
@@ -336,13 +384,7 @@ playwright-repl --replay examples/05-ci-pipe.pw --silent
 
 ## Architecture
 
-```
-┌──────────────┐     Unix Socket      ┌──────────────────┐     CDP      ┌─────────┐
-│ playwright-  │◄──── JSON/newline ───►│  Daemon Process  │◄────────────►│ Browser │
-│ repl         │                       │  (Playwright     │              │(Chrome/ │
-│              │                       │   MCP backend)   │              │ FF/WK)  │
-└──────────────┘                       └──────────────────┘              └─────────┘
-```
+![Architecture](architecture-diagram.png)
 
 The REPL replaces only the **client half** of playwright-cli. The daemon, browser, and all tool handlers are unchanged — both CLI and REPL produce identical wire messages.
 

package/bin/mcp-server.cjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+/**
+ * Thin MCP server entrypoint — uses Playwright's built-in MCP infrastructure.
+ * Starts a stdio MCP server with all browser tools available.
+ *
+ * Uses only publicly exported paths:
+ *   - playwright/lib/mcp/index        → createConnection()
+ *   - playwright-core/lib/mcpBundle   → StdioServerTransport
+ */
+
+const { createConnection } = require('playwright/lib/mcp/index');
+const { StdioServerTransport } = require('playwright-core/lib/mcpBundle');
+
+// ─── Parse CLI args ───
+
+const args = process.argv.slice(2);
+const headed = args.includes('--headed');
+
+(async () => {
+  const server = await createConnection({
+    browser: {
+      launchOptions: { headless: !headed },
+    },
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+})().catch(e => {
+  console.error(e.message);
+  process.exit(1);
+});

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "playwright-repl",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Interactive REPL for Playwright browser automation — keyword-driven testing from your terminal",
   "type": "module",
   "bin": {
-    "playwright-repl": "./bin/playwright-repl.mjs"
+    "playwright-repl": "./bin/playwright-repl.mjs",
+    "playwright-mcp-server": "./bin/mcp-server.cjs"
   },
   "main": "./src/index.mjs",
   "exports": {
@@ -36,7 +37,7 @@
     "examples/",
     "LICENSE",
     "README.md",
-    "RELEASES.md"
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18.0.0"