@browserstack/mcp-server 1.1.6 → 1.1.7

package/dist/config.js

@@ -1,12 +1,44 @@
+// List of supported BrowserStack Local option names (as per SDK)
+const BROWSERSTACK_LOCAL_OPTION_KEYS = [
+    "proxyHost",
+    "proxyPort",
+    "proxyUser",
+    "proxyPass",
+    "useCaCertificate",
+    "localProxyHost",
+    "localProxyPort",
+    "localProxyUser",
+    "localProxyPass",
+    "pacFile",
+    "force",
+    "forceLocal",
+    "onlyAutomate",
+    "verbose",
+    "logFile",
+    "binarypath",
+    "f",
+    "excludeHosts",
+];
+// Build browserstackLocalOptions from individual env vars
+const browserstackLocalOptions = {};
+for (const key of BROWSERSTACK_LOCAL_OPTION_KEYS) {
+    // Env var name: BROWSERSTACK_LOCAL_OPTION_<UPPERCASE_KEY>
+    const envVar = process.env[`BROWSERSTACK_LOCAL_OPTION_${key.toUpperCase()}`];
+    if (envVar !== undefined) {
+        browserstackLocalOptions[key] = envVar;
+    }
+}
 export class Config {
     browserstackUsername;
     browserstackAccessKey;
     DEV_MODE;
-    constructor(browserstackUsername, browserstackAccessKey, DEV_MODE) {
+    browserstackLocalOptions;
+    constructor(browserstackUsername, browserstackAccessKey, DEV_MODE, browserstackLocalOptions) {
         this.browserstackUsername = browserstackUsername;
         this.browserstackAccessKey = browserstackAccessKey;
         this.DEV_MODE = DEV_MODE;
+        this.browserstackLocalOptions = browserstackLocalOptions;
     }
 }
-const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY, process.env.DEV_MODE === "true");
+const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY, process.env.DEV_MODE === "true", browserstackLocalOptions);
 export default config;

package/dist/lib/local.js

@@ -69,15 +69,17 @@ export async function ensureLocalBinarySetup(localIdentifier) {
     logger.info("Ensuring local binary setup as it is required for private URLs...");
     const localBinary = new Local();
     await killExistingBrowserStackLocalProcesses();
-    const requestBody = {
+    // Use a single options object from config and extend with required fields
+    const bsLocalArgs = {
+        ...(config.browserstackLocalOptions || {}),
         key: config.browserstackAccessKey,
         username: config.browserstackUsername,
     };
     if (localIdentifier) {
-        requestBody.localIdentifier = localIdentifier;
+        bsLocalArgs.localIdentifier = localIdentifier;
     }
     return await new Promise((resolve, reject) => {
-        localBinary.start(requestBody, (error) => {
+        localBinary.start(bsLocalArgs, (error) => {
             if (error) {
                 logger.error(`Unable to start BrowserStack Local... please check your credentials and try again. Error: ${error}`);
                 reject(new Error(`Unable to configure local tunnel binary, please check your credentials and try again. Error: ${error}`));

package/dist/tools/accessiblity-utils/scanner.js

@@ -56,6 +56,9 @@ export class AccessibilityScanner {
         }
         catch (err) {
             if (axios.isAxiosError(err) && err.response?.data) {
+                if (err.response.status === 422) {
+                    throw new Error("A scan with this name already exists. please update the name and run again.");
+                }
                 const msg = err.response.data.error ||
                     err.response.data.message ||
                     err.message;

package/dist/tools/appautomate.js

@@ -47,13 +47,19 @@ async function takeAppScreenshot(args) {
             },
         };
         logger.info("Starting WebDriver session on BrowserStack...");
-        driver = await remote({
-            protocol: "https",
-            hostname: "hub.browserstack.com",
-            port: 443,
-            path: "/wd/hub",
-            capabilities,
-        });
+        try {
+            driver = await remote({
+                protocol: "https",
+                hostname: "hub.browserstack.com",
+                port: 443,
+                path: "/wd/hub",
+                capabilities,
+            });
+        }
+        catch (error) {
+            logger.error("Error initializing WebDriver:", error);
+            throw new Error("Failed to initialize the WebDriver or a timeout occurred. Please try again.");
+        }
         const screenshotBase64 = await driver.takeScreenshot();
         const compressed = await maybeCompressBase64(screenshotBase64);
         return {

package/dist/tools/applive-utils/start-session.js

@@ -38,6 +38,9 @@ export async function startSession(args) {
     // 6) Upload app
     const { app_url } = await uploadApp(appPath);
     logger.info(`App uploaded: ${app_url}`);
+    if (!app_url) {
+        throw new Error("Failed to upload app. Please try again.");
+    }
     // 7) Build URL & open
     const deviceParam = sanitizeUrlParam(selected.display_name.replace(/\s+/g, "+"));
     const params = new URLSearchParams({

package/dist/tools/sdk-utils/constants.js

@@ -29,6 +29,43 @@ In order to run tests on BrowserStack, run the following command:
 browserstack-sdk python <path-to-test-file>
 \`\`\`
 `;
+const argsInstruction = '<argLine>-javaagent:"${com.browserstack:browserstack-java-sdk:jar}"</argLine>';
+const javaInstructions = `
+Strictly Add the following dependencies to your \`pom.xml\`:
+\`\`\`xml
+<dependency>
+    <groupId>com.browserstack</groupId>
+    <artifactId>browserstack-java-sdk</artifactId>
+    <version>LATEST</version>
+    <scope>compile</scope>
+</dependency>
+
+${argsInstruction}
+\`\`\`
+
+For Gradle projects, add to \`build.gradle\`:
+\`\`\`groovy
+dependencies {
+    implementation 'com.browserstack:browserstack-java-sdk:LATEST'
+}
+\`\`\`
+
+Inform user to export:
+\`\`\`bash
+export BROWSERSTACK_USERNAME=${config.browserstackUsername}
+export BROWSERSTACK_ACCESS_KEY=${config.browserstackAccessKey}
+\`\`\`
+
+Run tests using:
+\`\`\`bash
+mvn clean test 
+\`\`\`
+
+Or for Gradle:
+\`\`\`bash
+gradle clean test
+\`\`\`
+`;
 export const SUPPORTED_CONFIGURATIONS = {
     nodejs: {
         playwright: {
@@ -55,4 +92,12 @@ export const SUPPORTED_CONFIGURATIONS = {
             behave: { instructions: pythonInstructions },
         },
     },
+    java: {
+        playwright: {},
+        selenium: {
+            testng: { instructions: javaInstructions },
+            cucumber: { instructions: javaInstructions },
+            junit: { instructions: javaInstructions },
+        },
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "BrowserStack's Official MCP Server",
   "main": "dist/index.js",
   "repository": {