@smartbear/mcp 0.7.0 → 0.9.0

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,15 @@
+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}`,
+            "zscale-source": "smartbear-mcp",
+        };
+    }
+}

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.7.0",
+  "version": "0.9.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",

package/dist/bugsnag/client/api/filters.js

@@ -1,167 +0,0 @@
-/**
- * Filters utility for BugSnag API
- *
- * This file provides utility functions for creating filter URL parameters
- * based on the BugSnag filtering specification described in the Filtering.md document.
- */
-import { z } from "zod";
-export const FilterValueSchema = z.object({
-    type: z.enum(["eq", "ne", "empty"]),
-    value: z.union([z.string(), z.boolean(), z.number()]),
-});
-export const FilterObjectSchema = z.record(z.array(FilterValueSchema));
-/**
- * Creates a filter value object for equality comparison
- *
- * @param value The value to compare against
- * @returns FilterValue with type 'eq'
- */
-export function equals(value) {
-    return {
-        type: "eq",
-        value,
-    };
-}
-/**
- * Creates a filter value object for inequality comparison
- *
- * @param value The value to compare against
- * @returns FilterValue with type 'ne'
- */
-export function notEquals(value) {
-    return {
-        type: "ne",
-        value,
-    };
-}
-/**
- * Creates a filter value object for checking if a field is empty or not
- *
- * @param isEmpty Whether the field should be empty (true) or not (false)
- * @returns FilterValue with type 'empty'
- */
-export function empty(isEmpty) {
-    return {
-        type: "empty",
-        value: isEmpty.toString(),
-    };
-}
-/**
- * Creates a relative time filter for event.since or event.before
- *
- * @param value The amount of time
- * @param unit The time unit ('h' for hours, 'd' for days)
- * @returns FilterValue for the relative time
- */
-export function relativeTime(value, unit) {
-    return {
-        type: "eq",
-        value: `${value}${unit}`,
-    };
-}
-/**
- * Creates an ISO 8601 time filter (must be in UTC format like 2018-05-20T00:00:00Z)
- *
- * @param date The date object to convert to ISO string
- * @returns FilterValue for the ISO time
- */
-export function isoTime(date) {
-    return {
-        type: "eq",
-        value: date.toISOString(),
-    };
-}
-/**
- * Converts a FilterObject to URL search parameters
- *
- * @param filters The filter object to convert
- * @returns URLSearchParams object with the encoded filters
- */
-export function toUrlSearchParams(filters) {
-    const params = new URLSearchParams();
-    Object.entries(filters).forEach(([field, filterValues]) => {
-        filterValues.forEach((filterValue) => {
-            params.append(`filters[${field}][][type]`, filterValue.type);
-            params.append(`filters[${field}][][value]`, filterValue.value.toString());
-        });
-    });
-    return params;
-}
-/**
- * Converts a FilterObject to a query string
- *
- * @param filters The filter object to convert
- * @returns Query string representation of the filters
- */
-export function toQueryString(filters) {
-    return toUrlSearchParams(filters).toString();
-}
-/**
- * Helper to build a FilterObject with type safety
- *
- * @returns An empty FilterObject that can be built upon
- */
-export function createFilter() {
-    return {};
-}
-/**
- * Adds a field filter to an existing FilterObject
- *
- * @param filters The FilterObject to add to
- * @param field The field name (e.g., 'error.status', 'event.since')
- * @param filterValue The FilterValue to add
- * @returns The updated FilterObject for chaining
- */
-export function addFilter(filters, field, filterValue) {
-    if (!filters[field]) {
-        filters[field] = [];
-    }
-    filters[field].push(filterValue);
-    return filters;
-}
-/**
- * Utility to create a time range filter between two dates
- *
- * @param filters The FilterObject to add to
- * @param since Start date
- * @param before End date
- * @returns The updated FilterObject for chaining
- */
-export function addTimeRange(filters, since, before) {
-    addFilter(filters, "event.since", isoTime(since));
-    addFilter(filters, "event.before", isoTime(before));
-    return filters;
-}
-/**
- * Utility to create a relative time range filter
- *
- * @param filters The FilterObject to add to
- * @param amount The amount of time (e.g., 7 for 7 days)
- * @param unit The time unit ('h' for hours, 'd' for days)
- * @returns The updated FilterObject for chaining
- */
-export function addRelativeTimeRange(filters, amount, unit) {
-    addFilter(filters, "event.since", relativeTime(amount, unit));
-    return filters;
-}
-/**
- * Usage examples:
- *
- * // Example 1: Open errors with events in the last day
- * const filters = createFilter();
- * addRelativeTimeRange(filters, 1, 'd');
- * addFilter(filters, 'error.status', equals('open'));
- * const queryString = toQueryString(filters);
- *
- * // Example 2: Events affecting specific users on a specific day
- * const filters = createFilter();
- * addTimeRange(filters, new Date('2017-01-01'), new Date('2017-01-02'));
- * addFilter(filters, 'user.email', equals('user1@example.com'));
- * addFilter(filters, 'user.email', equals('user2@example.com'));
- * const queryString = toQueryString(filters);
- *
- * // Example 3: Events that have user data
- * const filters = createFilter();
- * addFilter(filters, 'user.id', empty(false));
- * const queryString = toQueryString(filters);
- */

package/dist/bugsnag/client/configuration.js

@@ -1,10 +0,0 @@
-export class Configuration {
-    authToken;
-    basePath;
-    headers;
-    constructor(param) {
-        this.authToken = param.authToken;
-        this.basePath = param.basePath;
-        this.headers = param.headers || {};
-    }
-}

package/dist/bugsnag/client/index.js

@@ -1,2 +0,0 @@
-export * from "./api/index.js";
-export * from "./configuration.js";