@smartbear/mcp 0.6.0 → 0.8.0

package/dist/reflect/client.js

@@ -1,5 +1,5 @@
-import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
 import { z } from "zod";
+import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
 // ReflectClient class implementing the Client interface
 export class ReflectClient {
     headers;
@@ -61,7 +61,7 @@ export class ReflectClient {
         });
         return response.json();
     }
-    async getReflectTestStatus(testId, executionId) {
+    async getReflectTestStatus(_testId, executionId) {
         const response = await fetch(`https://api.reflect.run/v1/executions/${executionId}`, {
             method: "GET",
             headers: this.headers,
@@ -87,7 +87,7 @@ export class ReflectClient {
                     name: "suiteId",
                     type: z.string(),
                     description: "ID of the reflect suite to list executions for",
-                    required: true
+                    required: true,
                 },
             ],
         }, async (args, _extra) => {
@@ -106,13 +106,13 @@ export class ReflectClient {
                     name: "suiteId",
                     type: z.string(),
                     description: "ID of the reflect suite to get execution status for",
-                    required: true
+                    required: true,
                 },
                 {
                     name: "executionId",
                     type: z.string(),
                     description: "ID of the reflect suite execution to get status for",
-                    required: true
+                    required: true,
                 },
             ],
         }, async (args, _extra) => {
@@ -131,9 +131,9 @@ export class ReflectClient {
                     name: "suiteId",
                     type: z.string(),
                     description: "ID of the reflect suite to list executions for",
-                    required: true
-                }
-            ]
+                    required: true,
+                },
+            ],
         }, async (args, _extra) => {
             if (!args.suiteId)
                 throw new Error("suiteId argument is required");
@@ -150,13 +150,13 @@ export class ReflectClient {
                     name: "suiteId",
                     type: z.string(),
                     description: "ID of the reflect suite to cancel execution for",
-                    required: true
+                    required: true,
                 },
                 {
                     name: "executionId",
                     type: z.string(),
                     description: "ID of the reflect suite execution to cancel",
-                    required: true
+                    required: true,
                 },
             ],
         }, async (args, _extra) => {
@@ -185,8 +185,8 @@ export class ReflectClient {
                     name: "testId",
                     type: z.string(),
                     description: "ID of the reflect test to run",
-                    required: true
-                }
+                    required: true,
+                },
             ],
         }, async (args, _extra) => {
             if (!args.testId)
@@ -204,13 +204,13 @@ export class ReflectClient {
                     name: "testId",
                     type: z.string(),
                     description: "ID of the reflect test to run",
-                    required: true
+                    required: true,
                 },
                 {
                     name: "executionId",
                     type: z.string(),
                     description: "ID of the reflect test execution to get status for",
-                    required: true
+                    required: true,
                 },
             ],
         }, async (args, _extra) => {

package/dist/zephyr/client.js

@@ -0,0 +1,16 @@
+import { ApiClient } from "./common/api-client.js";
+import { GetProjects } from "./tool/project/get-projects.js";
+export class ZephyrClient {
+    apiClient;
+    name = "Zephyr";
+    prefix = "zephyr";
+    constructor(bearerToken, baseUrl = "https://api.zephyrscale.smartbear.com/v2") {
+        this.apiClient = new ApiClient(bearerToken, baseUrl);
+    }
+    registerTools(register, _getInput) {
+        const tools = [new GetProjects(this.apiClient)];
+        tools.forEach((tool) => {
+            register(tool.specification, tool.handle);
+        });
+    }
+}

package/dist/zephyr/common/api-client.js

@@ -0,0 +1,27 @@
+import { AuthService } from "./auth-service.js";
+export class ApiClient {
+    baseUrl;
+    defaultHeaders;
+    constructor(bearerToken, baseUrl) {
+        this.baseUrl = baseUrl.trim().replace(/\/$/, "");
+        this.defaultHeaders = new AuthService(bearerToken).getAuthHeaders();
+    }
+    getUrl(endpoint, params) {
+        const url = new URL(this.baseUrl + endpoint);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        return url.toString();
+    }
+    async get(endpoint, params) {
+        const response = await fetch(this.getUrl(endpoint, params), {
+            method: "GET",
+            headers: this.defaultHeaders,
+        });
+        return response.json();
+    }
+}

package/dist/zephyr/common/auth-service.js

@@ -0,0 +1,14 @@
+import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../common/info.js";
+export class AuthService {
+    bearerToken;
+    constructor(accessToken) {
+        this.bearerToken = accessToken.trim();
+    }
+    getAuthHeaders() {
+        return {
+            Authorization: `Bearer ${this.bearerToken}`,
+            "Content-Type": "application/json",
+            "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+        };
+    }
+}

package/dist/zephyr/common/types.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export const MaxResultsSchema = z
+    .number()
+    .min(1)
+    .max(1000)
+    .describe(`
+    Specifies the maximum number of results to return in a single call. The default value is 10, and the maximum value that can be requested is 1000.
+
+    Note that the server may enforce a lower limit than requested, depending on resource availability or other internal constraints.
+    If this happens, the result set may be truncated. Always check the maxResults value in the response to confirm how many results were actually returned.
+  `);
+export const StartAtSchema = z
+    .number()
+    .min(0)
+    .max(1000000)
+    .describe(`
+    Zero-indexed starting position used to paginate through results. Defaults to 0.
+  `);
+export const ZephyrProjectSchema = z.object({
+    id: z.number(),
+    jiraProjectId: z.number(),
+    key: z.string(),
+    enabled: z.boolean(),
+});
+export function createListSchema(itemSchema) {
+    return z.object({
+        next: z.string().nullable(),
+        startAt: StartAtSchema,
+        maxResults: MaxResultsSchema,
+        total: z.number(),
+        isLast: z.boolean(),
+        values: z.array(itemSchema),
+    });
+}
+export const ZephyrProjectListSchema = createListSchema(ZephyrProjectSchema);

package/dist/zephyr/tool/project/get-projects.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { MaxResultsSchema, StartAtSchema } from "../../common/types.js";
+export const GetProjectsInputSchema = z.object({
+    startAt: StartAtSchema.optional(),
+    maxResults: MaxResultsSchema.optional(),
+});
+export class GetProjects {
+    apiClient;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    specification = {
+        title: "Get Projects",
+        summary: "Get details of projects in Zephyr",
+        readOnly: true,
+        idempotent: true,
+        zodSchema: GetProjectsInputSchema,
+        examples: [
+            {
+                description: "Get the first 10 projects",
+                parameters: {
+                    maxResults: 10,
+                    startAt: 0,
+                },
+                expectedOutput: "The first 10 projects with their details",
+            },
+            {
+                description: "Get any project",
+                parameters: {
+                    maxResults: 1,
+                },
+                expectedOutput: "One project with its details",
+            },
+            {
+                description: "Get five projects starting from the 7th project of the list",
+                parameters: {
+                    maxResults: 5,
+                    startAt: 6,
+                },
+                expectedOutput: "The 7th to the 11th projects with their details",
+            },
+        ],
+    };
+    handle = async (args) => {
+        const { maxResults, startAt } = args;
+        const response = await this.apiClient.get("/projects", {
+            maxResults,
+            startAt,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(response) }],
+        };
+    };
+}

package/dist/zephyr/tool/zephyr-tool.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",
@@ -8,7 +8,8 @@
     "bugsnag",
     "reflect",
     "api-hub",
-    "pactflow"
+    "pactflow",
+    "zephyr"
   ],
   "homepage": "https://developer.smartbear.com/smartbear-mcp",
   "mcpName": "com.smartbear/smartbear-mcp",
@@ -31,7 +32,10 @@
   },
   "scripts": {
     "build": "tsc && shx chmod +x dist/*.js",
-    "lint": "eslint . --ext .ts",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint . --fix",
+    "format": "biome format . --write",
+    "format:check": "biome format .",
     "prepare": "npm run build",
     "watch": "tsc --watch",
     "test": "vitest",
@@ -50,15 +54,13 @@
     "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
-    "@eslint/js": "^9.29.0",
+    "@biomejs/biome": "^2.2.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22",
     "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^9.29.0",
     "globals": "^16.2.0",
     "shx": "^0.3.4",
     "typescript": "^5.6.2",
-    "typescript-eslint": "^8.34.1",
     "vitest": "^3.2.4",
     "vitest-fetch-mock": "^0.4.5"
   }