@wdio/mcp 3.3.0 → 3.4.0

package/README.md

@@ -426,6 +426,7 @@ All session types support `reporting` labels that appear in the BrowserStack Aut
 | `scroll`                 | Scroll in a direction (up/down) by specified pixels. Browser-only.                                                                                                                                     |
 | `execute_script`         | Execute arbitrary JavaScript in the browser, or Appium mobile commands on devices                                                                                                                      |
 | `switch_tab`             | Switch to a different browser tab by handle or 0-based index. Browser-only.                                                                                                                            |
+| `switch_frame`           | Switch into an iframe by CSS/XPath selector, or back to the top-level frame if no selector is given. Browser-only.                                                                                     |
 
 ### Element Interaction (Web & Mobile)
 

package/lib/server.js

@@ -46,7 +46,7 @@ var package_default = {
     type: "git",
     url: "git://github.com/webdriverio/mcp.git"
   },
-  version: "3.2.5",
+  version: "3.3.0",
   description: "MCP server with WebdriverIO for browser and mobile app automation (iOS/Android via Appium)",
   main: "./lib/server.js",
   module: "./lib/server.js",
@@ -3152,7 +3152,8 @@ function getAppiumServerConfig(overrides) {
   return {
     hostname: overrides?.hostname || process.env.APPIUM_URL || "127.0.0.1",
     port: overrides?.port || Number(process.env.APPIUM_URL_PORT) || 4723,
-    path: overrides?.path || process.env.APPIUM_PATH || "/"
+    path: overrides?.path || process.env.APPIUM_PATH || "/",
+    protocol: overrides?.protocol || process.env.APPIUM_PROTOCOL || "http"
   };
 }
 function buildIOSCapabilities(appPath, options) {
@@ -3235,12 +3236,12 @@ var LocalAppiumProvider = class {
   name = "local-appium";
   getConnectionConfig(options) {
     const appiumConfig = options.appiumConfig;
-    const config = getAppiumServerConfig({
+    return getAppiumServerConfig({
       hostname: appiumConfig?.host,
       port: appiumConfig?.port,
-      path: appiumConfig?.path
+      path: appiumConfig?.path,
+      protocol: appiumConfig?.protocol
     });
-    return { protocol: "http", ...config };
   }
   buildCapabilities(options) {
     const platform2 = options.platform;
@@ -3538,7 +3539,8 @@ var startSessionToolDefinition = {
     appiumConfig: z14.object({
       host: z14.string().optional(),
       port: z14.number().optional(),
-      path: z14.string().optional()
+      path: z14.string().optional(),
+      protocol: z14.string().optional()
     }).optional().describe("Appium server connection (local provider only)"),
     browserstackLocal: z14.union([coerceBoolean, z14.literal("external")]).optional().default(false).describe('Enable BrowserStack Local tunnel routing (BrowserStack only, default: false). true = auto-start tunnel before session and stop on close. "external" = tunnel already running externally, set local: true in capabilities only.'),
     navigationUrl: z14.string().optional().describe("URL to navigate to after starting"),
@@ -3823,9 +3825,39 @@ var switchTabTool = async ({ handle, index }) => {
   }
 };
 
+// src/tools/switch-frame.tool.ts
+init_state();
+import { z as z16 } from "zod";
+var switchFrameToolDefinition = {
+  name: "switch_frame",
+  description: "Switches into an iframe by CSS or XPath selector, or back to the top-level frame if no selector is given. Required before interacting with elements inside iframes \u2014 click, set_value, and get_elements only see the current frame context. Browser-only.",
+  inputSchema: {
+    selector: z16.string().optional().describe(
+      "CSS/XPath selector for the iframe element. Omit to switch back to the top-level frame."
+    )
+  }
+};
+var switchFrameTool = async ({
+  selector
+}) => {
+  try {
+    const browser = getBrowser();
+    if (!selector) {
+      await browser.switchFrame(null);
+      return { content: [{ type: "text", text: "Switched back to top-level frame" }] };
+    }
+    const iframe = await browser.$(selector);
+    await iframe.waitForExist({ timeout: 5e3 });
+    await browser.switchFrame(iframe);
+    return { content: [{ type: "text", text: `Switched to iframe: ${selector}` }] };
+  } catch (e) {
+    return { isError: true, content: [{ type: "text", text: `Error switching frame: ${e}` }] };
+  }
+};
+
 // src/tools/browserstack.tool.ts
 import { existsSync as existsSync2, createReadStream } from "fs";
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 var BS_API = "https://api-cloud.browserstack.com";
 function getAuth() {
   const user = process.env.BROWSERSTACK_USERNAME;
@@ -3844,9 +3876,9 @@ var listAppsToolDefinition = {
   name: "list_apps",
   description: "List apps uploaded to BrowserStack App Automate. Reads BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY from environment.",
   inputSchema: {
-    sortBy: z16.enum(["app_name", "uploaded_at"]).optional().default("uploaded_at").describe("Sort order for results"),
+    sortBy: z17.enum(["app_name", "uploaded_at"]).optional().default("uploaded_at").describe("Sort order for results"),
     organizationWide: coerceBoolean.optional().default(false).describe("List apps uploaded by all users in the organization (uses recent_group_apps endpoint). Defaults to false (own uploads only)."),
-    limit: z16.number().int().min(1).optional().default(20).describe("Maximum number of apps to return (only applies when organizationWide is true, default 20)")
+    limit: z17.number().int().min(1).optional().default(20).describe("Maximum number of apps to return (only applies when organizationWide is true, default 20)")
   }
 };
 var listAppsTool = async ({ sortBy = "uploaded_at", organizationWide = false, limit = 20 }) => {
@@ -3876,8 +3908,8 @@ var uploadAppToolDefinition = {
   name: "upload_app",
   description: "Upload a local .apk or .ipa to BrowserStack App Automate. Returns a bs:// URL for use in start_session.",
   inputSchema: {
-    path: z16.string().describe("Absolute path to the .apk or .ipa file"),
-    customId: z16.string().optional().describe("Optional custom ID for the app (used to reference it later)")
+    path: z17.string().describe("Absolute path to the .apk or .ipa file"),
+    customId: z17.string().optional().describe("Optional custom ID for the app (used to reference it later)")
   }
 };
 var uploadAppTool = async ({ path, customId }) => {
@@ -3930,14 +3962,14 @@ var screenshotTool = async () => {
 };
 
 // src/tools/accessibility.tool.ts
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 var accessibilityToolDefinition = {
   name: "get_accessibility_tree",
   description: "Returns the page accessibility tree with roles, names, and selectors. Browser-only. Supports filtering by ARIA roles and pagination via limit/offset.",
   inputSchema: {
-    limit: z17.number().optional().default(0).describe("Maximum number of nodes to return (0 = no limit)"),
-    offset: z17.number().optional().default(0).describe("Number of nodes to skip for pagination"),
-    roles: z17.array(z17.string()).optional().describe('Filter by ARIA roles, e.g. ["button", "link", "heading"]')
+    limit: z18.number().optional().default(0).describe("Maximum number of nodes to return (0 = no limit)"),
+    offset: z18.number().optional().default(0).describe("Number of nodes to skip for pagination"),
+    roles: z18.array(z18.string()).optional().describe('Filter by ARIA roles, e.g. ["button", "link", "heading"]')
   }
 };
 var accessibilityTool = async ({ limit = 0, offset = 0, roles }) => {
@@ -3984,12 +4016,12 @@ var getContextsTool = async () => {
 };
 
 // src/tools/app-state.tool.ts
-import { z as z18 } from "zod";
+import { z as z19 } from "zod";
 var appStateToolDefinition = {
   name: "get_app_state",
   description: "Returns the current state of a mobile app: not installed, not running, background, or foreground. Mobile-only.",
   inputSchema: {
-    bundleId: z18.string().describe('App bundle ID (iOS) or package name (Android), e.g. "com.example.app"')
+    bundleId: z19.string().describe('App bundle ID (iOS) or package name (Android), e.g. "com.example.app"')
   }
 };
 var appStateTool = async ({ bundleId }) => {
@@ -4001,12 +4033,12 @@ var appStateTool = async ({ bundleId }) => {
 };
 
 // src/tools/get-cookies.tool.ts
-import { z as z19 } from "zod";
+import { z as z20 } from "zod";
 var getCookiesToolDefinition = {
   name: "get_cookies",
   description: "Returns all cookies for the current session, or a single cookie by name. Use to verify auth state, session tokens, or feature flags after login flows.",
   inputSchema: {
-    name: z19.string().optional().describe("Cookie name to retrieve a specific cookie. If omitted, returns all cookies.")
+    name: z20.string().optional().describe("Cookie name to retrieve a specific cookie. If omitted, returns all cookies.")
   }
 };
 var getCookiesTool = async ({ name }) => {
@@ -4063,6 +4095,7 @@ function createServer() {
   registerTool(emulateDeviceToolDefinition, emulateDeviceTool);
   registerTool(navigateToolDefinition, withRecording("navigate", navigateTool));
   registerTool(switchTabToolDefinition, switchTabTool);
+  registerTool(switchFrameToolDefinition, switchFrameTool);
   registerTool(scrollToolDefinition, withRecording("scroll", scrollTool));
   registerTool(clickToolDefinition, withRecording("click_element", clickTool));
   registerTool(setValueToolDefinition, withRecording("set_value", setValueTool));