@wdio/mcp 2.0.0 → 2.2.0
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.
- package/README.md +15 -6
- package/lib/server.js +611 -302
- package/lib/server.js.map +1 -1
- package/lib/snapshot.d.ts +123 -0
- package/lib/snapshot.js +1178 -0
- package/lib/snapshot.js.map +1 -0
- package/package.json +12 -1
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# WebDriverIO MCP Server
|
|
2
2
|
|
|
3
3
|
A Model Context Protocol (MCP) server that enables Claude Desktop to interact with web browsers and mobile applications
|
|
4
|
-
using WebDriverIO. Automate Chrome
|
|
4
|
+
using WebDriverIO. Automate Chrome, Firefox, Edge, and Safari browsers plus iOS and Android apps—all through a unified interface.
|
|
5
5
|
|
|
6
6
|
## Installation
|
|
7
7
|
|
|
@@ -78,7 +78,7 @@ appium
|
|
|
78
78
|
|
|
79
79
|
### Browser Automation
|
|
80
80
|
|
|
81
|
-
- **Session Management**: Start and close
|
|
81
|
+
- **Session Management**: Start and close browser sessions (Chrome, Firefox, Edge, Safari) with headless/headed modes
|
|
82
82
|
- **Navigation & Interaction**: Navigate URLs, click elements, fill forms, and retrieve content
|
|
83
83
|
- **Page Analysis**: Get visible elements, accessibility trees, take screenshots
|
|
84
84
|
- **Cookie Management**: Get, set, and delete cookies
|
|
@@ -99,7 +99,7 @@ appium
|
|
|
99
99
|
|
|
100
100
|
| Tool | Description |
|
|
101
101
|
|---------------------|------------------------------------------------------------------------------------------|
|
|
102
|
-
| `start_browser` | Start a
|
|
102
|
+
| `start_browser` | Start a browser session (Chrome, Firefox, Edge, Safari; headless/headed, custom dimensions) |
|
|
103
103
|
| `start_app_session` | Start an iOS or Android app session via Appium (supports state preservation via noReset) |
|
|
104
104
|
| `close_session` | Close or detach from the current browser or app session (supports detach mode) |
|
|
105
105
|
|
|
@@ -202,6 +202,15 @@ You are a Testing expert, and want to assess the basic workflows of a web applic
|
|
|
202
202
|
// Default settings (headed mode, 1280x1080)
|
|
203
203
|
start_browser()
|
|
204
204
|
|
|
205
|
+
// Firefox
|
|
206
|
+
start_browser({browser: 'firefox'})
|
|
207
|
+
|
|
208
|
+
// Edge
|
|
209
|
+
start_browser({browser: 'edge'})
|
|
210
|
+
|
|
211
|
+
// Safari (headed only; requires macOS)
|
|
212
|
+
start_browser({browser: 'safari'})
|
|
213
|
+
|
|
205
214
|
// Headless mode
|
|
206
215
|
start_browser({headless: true})
|
|
207
216
|
|
|
@@ -393,7 +402,7 @@ This eliminates the need to manually handle permission popups during automated t
|
|
|
393
402
|
## Technical Details
|
|
394
403
|
|
|
395
404
|
- **Built with:** TypeScript, WebDriverIO, Appium
|
|
396
|
-
- **Browser Support:** Chrome (headed/headless, automated driver management)
|
|
405
|
+
- **Browser Support:** Chrome, Firefox, Edge (headed/headless, automated driver management), Safari (headed only; macOS)
|
|
397
406
|
- **Mobile Support:** iOS (XCUITest) and Android (UiAutomator2/Espresso)
|
|
398
407
|
- **Protocol:** Model Context Protocol (MCP) for Claude Desktop integration
|
|
399
408
|
- **Session Model:** Single active session (browser or mobile app)
|
|
@@ -404,7 +413,7 @@ This eliminates the need to manually handle permission popups during automated t
|
|
|
404
413
|
|
|
405
414
|
**Browser automation not working?**
|
|
406
415
|
|
|
407
|
-
- Ensure Chrome is installed
|
|
416
|
+
- Ensure Chrome, Firefox, Edge, or Safari is installed (Safari requires macOS)
|
|
408
417
|
- Try restarting Claude Desktop completely
|
|
409
418
|
- Check that no other WebDriver instances are running
|
|
410
419
|
|
|
@@ -415,4 +424,4 @@ This eliminates the need to manually handle permission popups during automated t
|
|
|
415
424
|
- Ensure correct platform drivers are installed
|
|
416
425
|
- Verify app path is correct and accessible
|
|
417
426
|
|
|
418
|
-
**Found issues or have suggestions?** Please share your feedback!
|
|
427
|
+
**Found issues or have suggestions?** Please share your feedback!
|