@smartbear/mcp 0.5.0 → 0.6.0

package/README.md

@@ -9,7 +9,7 @@
 
   <!-- Badges -->
   <div>
-    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/test.yml"><img src="https://github.com/SmartBear/smartbear-mcp/workflows/Test%20Suite/badge.svg" alt="Test Status"></a>
+    <a href="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml"><img src="https://github.com/SmartBear/smartbear-mcp/actions/workflows/node-ci.yml/badge.svg?branch=next" alt="Test Status"></a>
     <a href="https://smartbear.github.io/smartbear-mcp/"><img src="https://img.shields.io/badge/coverage-dynamic-brightgreen" alt="Coverage"></a>
     <a href="https://www.npmjs.com/package/@smartbear/mcp"><img src="https://img.shields.io/npm/v/@smartbear/mcp" alt="npm version"></a>
     <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Compatible-blue" alt="MCP Compatible"></a>
@@ -165,113 +165,7 @@ For detailed introduction, examples, and advanced configuration visit our 📖 [
 
 ## Local Development
 
-For developers who want to contribute to the SmartBear MCP server, customize its functionality, or work with the latest development features, you can build and run the server directly from source code. This approach gives you full control over the implementation and allows you to make modifications as needed.
-
-1. **Clone the repository:**
-   ```bash
-   git clone https://github.com/SmartBear/smartbear-mcp.git
-   cd smartbear-mcp
-   ```
-
-2. **Install dependencies:**
-   ```bash
-   npm install
-   ```
-
-3. **Build the server:**
-   ```bash
-   npm run build
-   ```
-
-4. **Add the server to your IDE** configuration updating `.vscode/mcp.json` (or equivalent) to point to your local build
-
-    <details>
-    <summary><strong>📋 VSCode (mcp.json)</strong></summary>
-
-    ```json
-    {
-      "servers": {
-        "smartbear": {
-        "type": "stdio",
-        "command": "node",
-        "dev": {                            // <-- To allow debugging in VS Code
-          "watch": "dist/**/*.js",
-          "debug": {
-              "type": "node"
-          },
-        },
-        "args": ["<PATH_TO_SMARTBEAR_MCP_REPO>/dist/index.js"],
-        "env": {
-            "BUGSNAG_AUTH_TOKEN": "${input:bugsnag_auth_token}",
-            "BUGSNAG_PROJECT_API_KEY": "${input:bugsnag_project_api_key}",
-            "REFLECT_API_TOKEN": "${input:reflect_api_token}",
-            "API_HUB_API_KEY": "${input:api_hub_api_key}",
-            "PACT_BROKER_BASE_URL": "${input:pact_broker_base_url}",
-            "PACT_BROKER_TOKEN": "${input:pact_broker_token}",
-            "PACT_BROKER_USERNAME": "${input:pact_broker_username}",
-            "PACT_BROKER_PASSWORD": "${input:pact_broker_password}"
-          }
-        }
-      },
-      "inputs": [
-        {
-          "id": "bugsnag_auth_token",
-          "type": "promptString",
-          "description": "BugSnag Auth Token - leave blank to disable BugSnag tools",
-          "password": true
-        },
-        {
-          "id": "bugsnag_project_api_key",
-          "type": "promptString",
-          "description": "BugSnag Project API Key - for single project interactions",
-          "password": false
-        },
-        {
-          "id": "reflect_api_token",
-          "type": "promptString",
-          "description": "Reflect API Token - leave blank to disable Reflect tools",
-          "password": true
-        },
-        {
-          "id": "api_hub_api_key",
-          "type": "promptString",
-          "description": "API Hub API Key - leave blank to disable API Hub tools",
-          "password": true
-        },
-        {
-          "id": "pact_broker_base_url",
-          "type": "promptString",
-          "description": "PactFlow or Pact Broker base url - leave blank to disable PactFlow tools",
-          "password": true
-        },
-        {
-          "id": "pact_broker_token",
-          "type": "promptString",
-          "description": "PactFlow Authentication Token",
-          "password": true
-        },
-        {
-          "id": "pact_broker_username",
-          "type": "promptString",
-          "description": "Pact Broker Username",
-          "password": true
-        },
-        {
-          "id": "pact_broker_password",
-          "type": "promptString",
-          "description": "Pact Broker Password",
-          "password": true
-        },
-      ]
-    }
-    ```
-    </details>
-
-5. **Local testing** using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) web interface:
-
-    ```bash
-    BUGSNAG_AUTH_TOKEN="your_token" REFLECT_API_TOKEN="your_reflect_token" API_HUB_API_KEY="your_api_hub_key" PACT_BROKER_BASE_URL="your-pactflow-url" PACT_BROKER_TOKEN="your-pactflow-token" PACT_BROKER_USERNAME="your-pact-broker-username" PACT_BROKER_PASSWORD="your-pact-broker-password" npx @modelcontextprotocol/inspector npx @smartbear/mcp@latest
-    ```
+For developers who want to contribute to the SmartBear MCP server, please see the [CONTRIBUTING.md](CONTRIBUTING.md) guide.
 
 ## License
 

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

@@ -39,7 +39,7 @@ export class CurrentUserAPI extends BaseAPI {
      * @returns A promise that resolves to the list of projects in the organization
      */
     async getOrganizationProjects(organizationId, options = {}) {
-        const { paginate = false, ...queryOptions } = options;
+        const { ...queryOptions } = options;
         const params = new URLSearchParams();
         for (const [key, value] of Object.entries(queryOptions)) {
             if (value !== undefined)
@@ -51,8 +51,7 @@ export class CurrentUserAPI extends BaseAPI {
         const data = await this.request({
             method: 'GET',
             url,
-        }, paginate);
-        // Only return allowed fields
+        }, true); // Always paginate for projects
         return {
             ...data,
             body: pickFieldsFromArray(data.body || [], CurrentUserAPI.projectFields)

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

@@ -1,12 +1,38 @@
-import { BaseAPI, pickFieldsFromArray } from "./base.js";
+import { BaseAPI, pickFieldsFromArray, pickFields } from "./base.js";
 // --- API Class ---
 export class ProjectAPI extends BaseAPI {
     static filterFields = ["errors_url", "events_url", "url", "html_url"];
-    static eventFieldFields = [
-        'custom',
-        'display_id',
-        'filter_options',
-        'pivot_options'
+    static eventFieldFields = ["custom", "display_id", "filter_options", "pivot_options"];
+    static buildFields = [
+        "id",
+        "release_time",
+        "app_version",
+        "release_stage",
+        "errors_introduced_count",
+        "errors_seen_count",
+        "total_sessions_count",
+        "unhandled_sessions_count",
+        "accumulative_daily_users_seen",
+        "accumulative_daily_users_with_unhandled",
+    ];
+    static releaseFields = [
+        "id",
+        "release_stage_name",
+        "app_version",
+        "first_released_at",
+        "first_release_id",
+        "releases_count",
+        "visible",
+        "total_sessions_count",
+        "unhandled_sessions_count",
+        "sessions_count_in_last_24h",
+        "accumulative_daily_users_seen",
+        "accumulative_daily_users_with_unhandled",
+    ];
+    static stabilityFields = [
+        "critical_stability",
+        "target_stability",
+        "stability_target_type",
     ];
     constructor(configuration) {
         super(configuration, ProjectAPI.filterFields);
@@ -44,4 +70,94 @@ export class ProjectAPI extends BaseAPI {
             body: data,
         });
     }
+    /**
+     * Retrieves the stability targets for a specific project.
+     * GET /projects/{project_id} (with internal header)
+     * @param projectId The ID of the project.
+     * @returns A promise that resolves to the project's stability targets.
+     */
+    async getProjectStabilityTargets(projectId) {
+        const url = `/projects/${projectId}`;
+        const response = await this.request({
+            method: "GET",
+            url,
+        });
+        return pickFields(response.body || {}, ProjectAPI.stabilityFields);
+    }
+    /**
+     * Lists builds for a specific project.
+     * GET /projects/{project_id}/releases
+     * @param projectId The ID of the project.
+     * @param opts Options for listing releases, including filtering by release stage.
+     * @returns A promise that resolves to an array of `ListReleasesResponse` objects.
+     */
+    async listBuilds(projectId, opts) {
+        const url = opts.next_url ?? `/projects/${projectId}/releases${opts.release_stage ? `?release_stage=${opts.release_stage}` : ""}`;
+        const response = await this.request({
+            method: "GET",
+            url,
+        });
+        return {
+            ...response,
+            body: pickFieldsFromArray(response.body || [], ProjectAPI.buildFields),
+        };
+    }
+    /**
+     * Retrieves a specific build from a project.
+     * GET /projects/{project_id}/releases/{release_id}
+     * @param projectId The ID of the project.
+     * @param buildId The ID of the release to retrieve.
+     * @returns A promise that resolves to the release data.
+     */
+    async getBuild(projectId, buildId) {
+        const url = `/projects/${projectId}/releases/${buildId}`;
+        return await this.request({
+            method: "GET",
+            url,
+        });
+    }
+    /**
+     * Lists releases for a specific project.
+     * GET /projects/{project_id}/release_groups
+     * @param projectId The ID of the project.
+     * @param opts Options for listing releases, including filtering by release stage and visibility.
+     * @returns A promise that resolves to an array of `ReleaseSummaryResponse` objects.
+     */
+    async listReleases(projectId, opts) {
+        const url = opts.next_url ?? `/projects/${projectId}/release_groups?release_stage_name=${opts.release_stage_name}&visible_only=${opts.visible_only}&top_only=true`;
+        const response = await this.request({
+            method: "GET",
+            url
+        });
+        return {
+            ...response,
+            body: pickFieldsFromArray(response.body || [], ProjectAPI.releaseFields),
+        };
+    }
+    /**
+     * Retrieves a specific release by its ID.
+     * GET /release_groups/{release_id}
+     * @param releaseId The ID of the release to retrieve.
+     * @returns A promise that resolves to the release data.
+     */
+    async getRelease(releaseId) {
+        const url = `/release_groups/${releaseId}`;
+        return await this.request({
+            method: "GET",
+            url,
+        });
+    }
+    /**
+     * Lists builds associated with a specific release group.
+     * GET /release_groups/{release_id}/releases
+     * @param releaseId The ID of the release group.
+     * @return A promise that resolves to an array of `BuildResponse` objects.
+     */
+    async listBuildsInRelease(releaseId) {
+        const url = `/release_groups/${releaseId}/releases`;
+        return await this.request({
+            method: "GET",
+            url,
+        }, true);
+    }
 }

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

@@ -12,6 +12,24 @@ export function pickFields(obj, keys) {
 export function pickFieldsFromArray(arr, keys) {
     return arr.map(obj => pickFields(obj, keys));
 }
+// Utility to extract next URL path from Link header
+export function getNextUrlPathFromHeader(headers, basePath) {
+    if (!headers)
+        return null;
+    const link = headers.get("link") || headers.get("Link");
+    if (!link)
+        return null;
+    const match = link.match(/<([^>]+)>;\s*rel="next"/)?.[1];
+    if (!match)
+        return null;
+    return match.replace(basePath, "");
+}
+// Ensure URL is absolute
+// The MCP tools exposed use only the path for pagination
+// For making requests, we need to ensure the URL is absolute
+export function ensureFullUrl(url, basePath) {
+    return url.startsWith('http') ? url : `${basePath}${url}`;
+}
 export class BaseAPI {
     configuration;
     filterFields;
@@ -30,11 +48,11 @@ export class BaseAPI {
             headers,
             body: options.body ? JSON.stringify(options.body) : undefined,
         };
-        const url = options.url.startsWith('http') ? options.url : `${this.configuration.basePath || ''}${options.url}`;
         let results = [];
-        let nextUrl = url;
+        let nextUrl = options.url;
         let apiResponse;
         do {
+            nextUrl = ensureFullUrl(nextUrl, this.configuration.basePath);
             const response = await fetch(nextUrl, fetchOptions);
             if (!response.ok) {
                 const errorText = await response.text();
@@ -47,14 +65,7 @@ export class BaseAPI {
             const data = await response.json();
             if (paginate) {
                 results = results.concat(data);
-                const link = response.headers.get('Link');
-                if (link) {
-                    const match = link.match(/<([^>]+)>;\s*rel="next"/);
-                    nextUrl = match ? match[1] : undefined;
-                }
-                else {
-                    nextUrl = undefined;
-                }
+                nextUrl = getNextUrlPathFromHeader(response.headers, this.configuration.basePath);
             }
             else {
                 apiResponse.body = data;