@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 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 browsers, iOS apps, and Android apps—all through a unified interface.
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 Chrome browser sessions with headless/headed modes
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 Chrome browser session (headless/headed, custom dimensions) |
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!