@playwright/mcp 0.0.41 → 0.0.42-alpha-2025-10-11

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 (3) hide show
  1. package/README.md +54 -6
  2. package/config.d.ts +5 -0
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -38,6 +38,31 @@ First, install the Playwright MCP server with your client.
38
38
 
39
39
  [<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D)
40
40
 
41
+ <details>
42
+ <summary>Amp</summary>
43
+
44
+ Add via the Amp VS Code extension settings screen or by updating your settings.json file:
45
+
46
+ ```json
47
+ "amp.mcpServers": {
48
+ "playwright": {
49
+ "command": "npx",
50
+ "args": [
51
+ "@playwright/mcp@latest"
52
+ ]
53
+ }
54
+ }
55
+ ```
56
+
57
+ **Amp CLI Setup:**
58
+
59
+ Add via the `amp mcp add`command below
60
+
61
+ ```bash
62
+ amp mcp add playwright -- npx @playwright/mcp@latest
63
+ ```
64
+
65
+ </details>
41
66
 
42
67
  <details>
43
68
  <summary>Claude Code</summary>
@@ -165,6 +190,27 @@ code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@la
165
190
  After installation, the Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code.
166
191
  </details>
167
192
 
193
+ <details>
194
+ <summary>Warp</summary>
195
+
196
+ Go to `Settings` -> `AI` -> `Manage MCP Servers` -> `+ Add` to [add an MCP Server](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server). Use the standard config above.
197
+
198
+ Alternatively, use the slash command `/add-mcp` in the Warp prompt and paste the standard config from above:
199
+ ```js
200
+ {
201
+ "mcpServers": {
202
+ "playwright": {
203
+ "command": "npx",
204
+ "args": [
205
+ "@playwright/mcp@latest"
206
+ ]
207
+ }
208
+ }
209
+ }
210
+ ```
211
+
212
+ </details>
213
+
168
214
  <details>
169
215
  <summary>Windsurf</summary>
170
216
 
@@ -254,6 +300,8 @@ Playwright MCP server supports following arguments. They can be provided in the
254
300
  all connected HTTP clients.
255
301
  --storage-state <path> path to the storage state file for
256
302
  isolated sessions.
303
+ --test-id-attribute <attribute> specify the attribute to use for test
304
+ ids, defaults to "data-testid"
257
305
  --timeout-action <timeout> specify action timeout in milliseconds,
258
306
  defaults to 5000ms
259
307
  --timeout-navigation <timeout> specify navigation timeout in
@@ -502,7 +550,7 @@ http.createServer(async (req, res) => {
502
550
  - Title: Close browser
503
551
  - Description: Close the page
504
552
  - Parameters: None
505
- - Read-only: **true**
553
+ - Read-only: **false**
506
554
 
507
555
  <!-- NOTE: This has been generated via update-readme.js -->
508
556
 
@@ -572,7 +620,7 @@ http.createServer(async (req, res) => {
572
620
  - Parameters:
573
621
  - `element` (string): Human-readable element description used to obtain permission to interact with the element
574
622
  - `ref` (string): Exact target element reference from the page snapshot
575
- - Read-only: **true**
623
+ - Read-only: **false**
576
624
 
577
625
  <!-- NOTE: This has been generated via update-readme.js -->
578
626
 
@@ -589,7 +637,7 @@ http.createServer(async (req, res) => {
589
637
  - Title: Go back
590
638
  - Description: Go back to the previous page
591
639
  - Parameters: None
592
- - Read-only: **true**
640
+ - Read-only: **false**
593
641
 
594
642
  <!-- NOTE: This has been generated via update-readme.js -->
595
643
 
@@ -616,7 +664,7 @@ http.createServer(async (req, res) => {
616
664
  - Parameters:
617
665
  - `width` (number): Width of the browser window
618
666
  - `height` (number): Height of the browser window
619
- - Read-only: **true**
667
+ - Read-only: **false**
620
668
 
621
669
  <!-- NOTE: This has been generated via update-readme.js -->
622
670
 
@@ -672,7 +720,7 @@ http.createServer(async (req, res) => {
672
720
  - `time` (number, optional): The time to wait in seconds
673
721
  - `text` (string, optional): The text to wait for
674
722
  - `textGone` (string, optional): The text to wait for to disappear
675
- - Read-only: **true**
723
+ - Read-only: **false**
676
724
 
677
725
  </details>
678
726
 
@@ -740,7 +788,7 @@ http.createServer(async (req, res) => {
740
788
  - `element` (string): Human-readable element description used to obtain permission to interact with the element
741
789
  - `x` (number): X coordinate
742
790
  - `y` (number): Y coordinate
743
- - Read-only: **true**
791
+ - Read-only: **false**
744
792
 
745
793
  </details>
746
794
 
package/config.d.ts CHANGED
@@ -149,6 +149,11 @@ export type Config = {
149
149
  blockedOrigins?: string[];
150
150
  };
151
151
 
152
+ /**
153
+ * Specify the attribute to use for test ids, defaults to "data-testid".
154
+ */
155
+ testIdAttribute?: string;
156
+
152
157
  timeouts?: {
153
158
  /*
154
159
  * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@playwright/mcp",
3
- "version": "0.0.41",
3
+ "version": "0.0.42-alpha-2025-10-11",
4
4
  "description": "Playwright Tools for MCP",
5
5
  "repository": {
6
6
  "type": "git",
@@ -35,15 +35,15 @@
35
35
  }
36
36
  },
37
37
  "dependencies": {
38
- "playwright": "1.56.0-alpha-2025-10-01",
39
- "playwright-core": "1.56.0-alpha-2025-10-01"
38
+ "playwright": "1.57.0-alpha-2025-10-09",
39
+ "playwright-core": "1.57.0-alpha-2025-10-09"
40
40
  },
41
41
  "bin": {
42
42
  "mcp-server-playwright": "cli.js"
43
43
  },
44
44
  "devDependencies": {
45
45
  "@modelcontextprotocol/sdk": "^1.17.5",
46
- "@playwright/test": "1.56.0-alpha-2025-10-01",
46
+ "@playwright/test": "1.57.0-alpha-2025-10-09",
47
47
  "@types/node": "^24.3.0",
48
48
  "zod-to-json-schema": "^3.24.6"
49
49
  }