Merge branch 'main' of https://github.com/aryan4codes/mcp-server-aryan

Author: aryan4codes

.github/workflows/npm-publish.yml

@@ -0,0 +1,66 @@
+name: "Release New Version"
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    name: "Publish to NPM"
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: "Checkout source code"
+        uses: actions/checkout@v2
+
+      - name: "Set up Node.js"
+        uses: actions/setup-node@v3
+        with:
+          node-version: 22.x
+          registry-url: "https://registry.npmjs.org/"
+
+      - name: "Install dependencies"
+        run: npm ci
+
+      - name: "Add node_modules/.bin to PATH"
+        run: echo "$(npm bin)" >> $GITHUB_PATH
+
+      - name: "Build package"
+        run: npm run build
+
+      - name: "Set Git user name and email"
+        run: |
+          git config --global user.name "github-actions"
+          git config --global user.email "[email protected]"
+
+      - name: "Bump patch version"
+        run: npm version patch
+
+      - name: "Get new version"
+        id: get_version
+        run: echo "version=v$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+      - name: "Push version bump commit and tag"
+        run: |
+          git push origin HEAD
+          git push origin --tags
+
+      - name: "Publish to NPM"
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: "Create GitHub Release"
+        uses: actions/create-release@v1
+        with:
+          tag_name: ${{ steps.get_version.outputs.version }}
+          release_name: Release ${{ steps.get_version.outputs.version }}
+          body: |
+            ```
+            • See CHANGELOG.md for details
+            • Published by ${{ github.actor }}
+            ```
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Dockerfile

@@ -0,0 +1,26 @@
+# Generated by https://smithery.ai. See: https://smithery.ai/docs/config#dockerfile
+# syntax=docker/dockerfile:1.4
+
+# Build stage
+FROM node:lts-alpine AS builder
+WORKDIR /app
+
+# Install dependencies
+COPY package.json package-lock.json ./
+RUN npm ci --ignore-scripts
+
+# Copy source and build
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:lts-alpine AS runtime
+WORKDIR /app
+
+# Copy built artifacts and production dependencies
+COPY --from=builder /app/dist ./dist
+COPY package.json package-lock.json ./
+RUN npm ci --only=production --ignore-scripts
+
+# Default command to start the MCP server
+ENTRYPOINT ["node", "dist/index.js"]

README.md

@@ -154,6 +154,14 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
    }
    ```
 
+### Installing via Smithery
+
+To install BrowserStack Test Platform Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@browserstack/mcp-server):
+
+```bash
+npx -y @smithery/cli install @browserstack/mcp-server --client claude
+```
+
 ## 🤝 Recommended MCP Clients
 
 - We recommend using **Github Copilot or Cursor** for automated testing + debugging use cases.

package-lock.json

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

package.json

@@ -0,0 +1,24 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+startCommand:
+  type: stdio
+  configSchema:
+    # JSON Schema defining the configuration options for the MCP.
+    type: object
+    required:
+      - browserstackUsername
+      - browserstackAccessKey
+    properties:
+      browserstackUsername:
+        type: string
+        description: BrowserStack username
+      browserstackAccessKey:
+        type: string
+        description: BrowserStack access key
+  commandFunction:
+    # A JS function that produces the CLI command based on the given config to start the MCP on stdio.
+    |-
+    (config) => ({ command: 'node', args: ['dist/index.js'], env: { BROWSERSTACK_USERNAME: config.browserstackUsername, BROWSERSTACK_ACCESS_KEY: config.browserstackAccessKey } })
+  exampleConfig:
+    browserstackUsername: myuser
+    browserstackAccessKey: myaccesskey

smithery.yaml

@@ -11,6 +11,7 @@ import addObservabilityTools from "./tools/observability";
 import addBrowserLiveTools from "./tools/live";
 import addAccessibilityTools from "./tools/accessibility";
 import addAutomateTools from "./tools/automate";
+import addTestManagementTools from "./tools/testmanagement";
 
 function registerTools(server: McpServer) {
   addSDKTools(server);
@@ -19,6 +20,7 @@ function registerTools(server: McpServer) {
   addObservabilityTools(server);
   addAccessibilityTools(server);
   addAutomateTools(server);
+  addTestManagementTools(server);
 }
 
 // Create an MCP server

src/index.ts

@@ -0,0 +1,30 @@
+import { AxiosError } from "axios";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+
+/**
+ * Formats an AxiosError into a CallToolResult with an appropriate message.
+ * @param err - The error object to format
+ * @param defaultText - The fallback error message
+ */
+export function formatAxiosError(
+  err: unknown,
+  defaultText: string,
+): CallToolResult {
+  let text = defaultText;
+
+  if (err instanceof AxiosError && err.response?.data) {
+    const message =
+      err.response.data.message ||
+      err.response.data.error ||
+      err.message ||
+      defaultText;
+    text = message;
+  } else if (err instanceof Error) {
+    text = err.message;
+  }
+
+  return {
+    content: [{ type: "text", text }],
+    isError: true,
+  };
+}

src/lib/error.ts

@@ -0,0 +1,64 @@
+// 1. Compute Levenshtein distance between two strings
+function levenshtein(a: string, b: string): number {
+  const dp: number[][] = Array(a.length + 1)
+    .fill(0)
+    .map(() => Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++) dp[i][0] = i;
+  for (let j = 0; j <= b.length; j++) dp[0][j] = j;
+
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1, // deletion
+        dp[i][j - 1] + 1, // insertion
+        dp[i - 1][j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1), // substitution
+      );
+    }
+  }
+  return dp[a.length][b.length];
+}
+
+// 2. Score one item against the query (normalized score 0–1)
+function scoreItem<T>(
+  item: T,
+  keys: Array<keyof T | string>,
+  queryTokens: string[],
+): number {
+  let best = Infinity;
+  for (const key of keys) {
+    const field = String(item[key as keyof T] ?? "").toLowerCase();
+    const fieldTokens = field.split(/\s+/);
+    const tokenScores = queryTokens.map((qt) => {
+      const minNormalized = Math.min(
+        ...fieldTokens.map((ft) => {
+          const rawDist = levenshtein(ft, qt);
+          const maxLen = Math.max(ft.length, qt.length);
+          return maxLen === 0 ? 0 : rawDist / maxLen; // normalized 0–1
+        }),
+      );
+      return minNormalized;
+    });
+    const avg = tokenScores.reduce((a, b) => a + b, 0) / tokenScores.length;
+    best = Math.min(best, avg);
+  }
+  return best;
+}
+
+// 3. The search entrypoint
+export function customFuzzySearch<T>(
+  list: T[],
+  keys: Array<keyof T | string>,
+  query: string,
+  limit: number = 5,
+  maxDistance: number = 0.6,
+): T[] {
+  const q = query.toLowerCase().trim();
+  const queryTokens = q.split(/\s+/);
+
+  return list
+    .map((item) => ({ item, score: scoreItem(item, keys, queryTokens) }))
+    .filter((x) => x.score <= maxDistance)
+    .sort((a, b) => a.score - b.score)
+    .slice(0, limit)
+    .map((x) => x.item);
+}

src/lib/fuzzy.ts

@@ -0,0 +1,31 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+
+const CACHE_DIR = path.join(os.homedir(), ".browserstack", "app_live_cache");
+const CACHE_FILE = path.join(CACHE_DIR, "app_live.json");
+const TTL_MS = 24 * 60 * 60 * 1000; // 1 day
+
+/**
+ * Fetches and caches the App Live devices JSON with a 1-day TTL.
+ */
+export async function getAppLiveData(): Promise<any> {
+  if (!fs.existsSync(CACHE_DIR)) {
+    fs.mkdirSync(CACHE_DIR, { recursive: true });
+  }
+  if (fs.existsSync(CACHE_FILE)) {
+    const stats = fs.statSync(CACHE_FILE);
+    if (Date.now() - stats.mtimeMs < TTL_MS) {
+      return JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
+    }
+  }
+  const response = await fetch(
+    "https://www.browserstack.com/list-of-browsers-and-platforms/app_live.json",
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to fetch app live list: ${response.statusText}`);
+  }
+  const data = await response.json();
+  fs.writeFileSync(CACHE_FILE, JSON.stringify(data), "utf8");
+  return data;
+}