@nbakka/mcp-appium 4.0.8 → 4.0.9

package/lib/server.js

@@ -1677,6 +1677,120 @@ tool(
  }
 );
 
+    // Helper: read BrowserStack credentials from ~/Desktop/browserstack-config.json
+    const getBrowserStackAuth = async () => {
+        const configPath = path.join(os.homedir(), "Desktop", "browserstack-config.json");
+        const raw = await fs.readFile(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        if (!config.username) throw new Error("'username' field missing in browserstack-config.json");
+        if (!config.accessKey) throw new Error("'accessKey' field missing in browserstack-config.json");
+        return { username: config.username, accessKey: config.accessKey };
+    };
+
+    tool(
+        "browserstack_create_subfolder",
+        "Create a sub-folder inside a parent folder in BrowserStack Test Management. Use this after classifying test cases by feature to create a named sub-folder for that feature.",
+        {
+            projectId: zod_1.z.string().describe("BrowserStack project ID, e.g. PR-1"),
+            parentFolderId: zod_1.z.number().int().describe("Numeric ID of the parent folder in which to create the sub-folder"),
+            folderName: zod_1.z.string().describe("Name of the new sub-folder"),
+            folderDescription: zod_1.z.string().optional().describe("Optional description of the sub-folder"),
+        },
+        async ({ projectId, parentFolderId, folderName, folderDescription }) => {
+            const { username, accessKey } = await getBrowserStackAuth();
+            const response = await axios.post(
+                `https://test-management.browserstack.com/api/v2/projects/${projectId}/folders`,
+                {
+                    folder: {
+                        name: folderName,
+                        description: folderDescription || "",
+                        parent_id: parentFolderId,
+                    },
+                },
+                {
+                    auth: { username, password: accessKey },
+                    headers: { "Content-Type": "application/json" },
+                }
+            );
+            const folder = response.data.folder;
+            return `✅ Sub-folder created: "${folder.name}" (id: ${folder.id}) under parent folder ${parentFolderId}`;
+        }
+    );
+
+    tool(
+        "browserstack_get_test_cases",
+        "Fetch all test cases inside a folder from BrowserStack Test Management. Returns identifier, title, and folder_id for each test case so the LLM can classify them into features.",
+        {
+            projectId: zod_1.z.string().describe("BrowserStack project ID, e.g. PR-1"),
+            folderId: zod_1.z.number().int().describe("Numeric ID of the folder whose test cases should be fetched"),
+        },
+        async ({ projectId, folderId }) => {
+            const { username, accessKey } = await getBrowserStackAuth();
+            const allTestCases = [];
+            let page = 1;
+
+            while (true) {
+                const response = await axios.get(
+                    `https://test-management.browserstack.com/api/v2/projects/${projectId}/test-cases`,
+                    {
+                        params: { folder_id: folderId, p: page },
+                        auth: { username, password: accessKey },
+                    }
+                );
+                const data = response.data;
+                const cases = data.test_cases || [];
+                allTestCases.push(...cases);
+                // Stop when there is no next page
+                if (!data.info || !data.info.next) break;
+                page++;
+            }
+
+            if (allTestCases.length === 0) {
+                return `No test cases found in folder ${folderId}.`;
+            }
+
+            const summary = allTestCases
+                .map(tc => `- identifier: ${tc.identifier} | title: ${tc.title}`)
+                .join("\n");
+            return `Found ${allTestCases.length} test case(s) in folder ${folderId}:\n${summary}`;
+        }
+    );
+
+    tool(
+        "browserstack_bulk_move_test_cases",
+        "Bulk move test cases into a destination folder in BrowserStack Test Management. Use this after classifying test cases and creating the target sub-folder. Supports up to 1000 test case IDs per call.",
+        {
+            projectId: zod_1.z.string().describe("BrowserStack project ID, e.g. PR-1"),
+            testCaseIds: zod_1.z.array(zod_1.z.string()).describe("Array of test case identifiers to move, e.g. [\"TC-0042\", \"TC-0188\"]"),
+            destinationFolderId: zod_1.z.number().int().describe("Numeric ID of the destination folder"),
+        },
+        async ({ projectId, testCaseIds, destinationFolderId }) => {
+            const { username, accessKey } = await getBrowserStackAuth();
+            const response = await axios.post(
+                `https://test-management.browserstack.com/api/v2/projects/${projectId}/test-cases/move`,
+                {
+                    test_case: {
+                        ids: testCaseIds,
+                        destination_folder_id: destinationFolderId,
+                    },
+                },
+                {
+                    auth: { username, password: accessKey },
+                    headers: { "Content-Type": "application/json" },
+                }
+            );
+            const results = response.data.results || {};
+            const moved = results.moved || [];
+            const errors = results.errors || [];
+            let msg = `✅ Moved ${moved.length}/${testCaseIds.length} test case(s) to folder ${destinationFolderId}.`;
+            if (errors.length > 0) {
+                const errorDetails = errors.map(e => `  - ${e.id}: ${e.message}`).join("\n");
+                msg += `\n⚠️ ${errors.length} error(s):\n${errorDetails}`;
+            }
+            return msg;
+        }
+    );
+
     return server;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "4.0.8",
+  "version": "4.0.9",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"