zephyr-scale-mcp-server 0.3.0 → 0.3.2

package/README.md

@@ -68,7 +68,7 @@ The server automatically detects your Jira environment and uses the appropriate
 - **Jira Cloud**: Uses Zephyr Scale API v2.
 - **Jira Data Center**: Uses Zephyr Scale API v1.
 
-This may result in slightly different behavior for some tools, such as `add_test_cases_to_run`.
+Some tools are platform-specific. For example, `add_test_cases_to_run` is only available on Cloud, as the Data Center API (v1) does not support modifying test runs after creation.
 
 ### Resource System
 The server provides access to various resources through URI schemes:
@@ -88,11 +88,12 @@ The server provides access to various resources through URI schemes:
 - `create_test_run`: Create a new test run.
 - `get_test_run`: Get detailed information about a specific test run.
 - `get_test_run_cases`: Get test case keys from a test run.
-- `add_test_cases_to_run`: Add test cases to an existing test run.
+- `add_test_cases_to_run`: Add test cases to an existing test run. *(Cloud only)*
 
 ### Test Execution & Search
 - `get_test_execution`: Get detailed individual test execution results.
 - `search_test_cases_by_folder`: Search for test cases in a specific folder.
+- `search_test_runs`: Search for test runs by project key and/or folder path.
 
 ### Organization
 - `create_folder`: Create a new folder in Zephyr Scale.

package/build/index.js

@@ -14,7 +14,7 @@ class ZephyrServer {
         const jiraConfig = createJiraConfig();
         this.server = new Server({
             name: 'zephyr-server',
-            version: '0.3.0',
+            version: '0.3.1',
         }, {
             capabilities: {
                 tools: {},
@@ -55,6 +55,8 @@ class ZephyrServer {
                         return await this.toolHandlers.getTestRunCases(args);
                     case 'delete_test_case':
                         return await this.toolHandlers.deleteTestCase(args);
+                    case 'delete_test_run':
+                        return await this.toolHandlers.deleteTestRun(args);
                     case 'create_test_run':
                         return await this.toolHandlers.createTestRun(args);
                     case 'get_test_run':

package/build/tool-handlers.js

@@ -273,6 +273,26 @@ export class ZephyrToolHandlers {
             throw new McpError(ErrorCode.InternalError, `Failed to delete test case: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    async deleteTestRun(args) {
+        const { test_run_key } = args;
+        try {
+            const response = await this.axiosInstance.delete(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`);
+            if (response.status === 204) {
+                return {
+                    content: [{ type: 'text', text: `Test run ${test_run_key} deleted successfully.` }],
+                };
+            }
+            else {
+                return {
+                    content: [{ type: 'text', text: `Failed to delete test run. Status: ${response.status}` }],
+                    isError: true,
+                };
+            }
+        }
+        catch (error) {
+            throw new McpError(ErrorCode.InternalError, `Failed to delete test run: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     async createTestRun(args) {
         const { project_key, name, test_case_keys, test_plan_key, folder, planned_start_date, planned_end_date, description, owner, environment, issue_key, issue_links, custom_fields } = args;
         // Build the basic payload
@@ -557,48 +577,18 @@ export class ZephyrToolHandlers {
     }
     async addTestCasesToRun(args) {
         const { test_run_key, test_case_keys } = args;
+        if (this.jiraConfig.type === 'datacenter') {
+            throw new McpError(ErrorCode.InvalidRequest, 'add_test_cases_to_run is only supported on Zephyr Scale Cloud. The Data Center API (v1) does not provide an endpoint to modify test runs after creation.');
+        }
         try {
-            // For Data Center, we need to get the current items and then update
-            if (this.jiraConfig.type === 'datacenter') {
-                const getResponse = await this.axiosInstance.get(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`);
-                const existingItems = getResponse.data.items || [];
-                const existingKeys = new Set(existingItems.map((item) => item.testCaseKey));
-                const newItems = test_case_keys
-                    .filter(key => !existingKeys.has(key))
-                    .map(key => ({ testCaseKey: key, testResultStatus: 'Not Executed' }));
-                if (newItems.length > 0) {
-                    let response;
-                    if (this.jiraConfig.type === 'datacenter') {
-                        const minimalPayload = {
-                            items: [...existingItems, ...newItems]
-                        };
-                        response = await this.axiosInstance.put(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`, minimalPayload);
-                    }
-                    else {
-                        const postPayload = { items: newItems.map(item => item.testCaseKey) };
-                        response = await this.axiosInstance.post(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}/testcases`, postPayload);
-                    }
-                    if (response.status === 200 || response.status === 201 || response.status === 204) {
-                        return {
-                            content: [{ type: 'text', text: `Added ${newItems.length} new test cases to test run ${test_run_key}.` }],
-                        };
-                    }
-                }
-                else {
-                    return {
-                        content: [{ type: 'text', text: 'All specified test cases are already in the test run.' }],
-                    };
-                }
-            }
-            else {
-                // For Cloud, we can just post the new test case keys
-                const fullPayload = { items: test_case_keys };
-                const response = await this.axiosInstance.put(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`, fullPayload);
-                if (response.status === 200 || response.status === 204) {
-                    return {
-                        content: [{ type: 'text', text: `Successfully updated test cases for test run ${test_run_key}.` }],
-                    };
-                }
+            const payload = {
+                items: test_case_keys.map(key => ({ testCaseKey: key }))
+            };
+            const response = await this.axiosInstance.post(`/testcycles/${test_run_key}/testcases`, payload);
+            if (response.status === 200 || response.status === 201 || response.status === 204) {
+                return {
+                    content: [{ type: 'text', text: `Added ${test_case_keys.length} test case(s) to test run ${test_run_key}.` }],
+                };
             }
         }
         catch (error) {

package/build/tool-schemas.js

@@ -373,9 +373,23 @@ export const toolSchemas = [
             },
         },
     },
+    {
+        name: 'delete_test_run',
+        description: 'Delete a specific test run',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                test_run_key: {
+                    type: 'string',
+                    description: 'Test run key to delete (e.g., PROJ-R123)',
+                },
+            },
+            required: ['test_run_key'],
+        },
+    },
     {
         name: 'add_test_cases_to_run',
-        description: 'Add test cases to an existing test run',
+        description: 'Add test cases to an existing test run (Cloud only — not supported on Data Center)',
         inputSchema: {
             type: 'object',
             properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zephyr-scale-mcp-server",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Model Context Protocol (MCP) server for Zephyr Scale test case management with comprehensive STEP_BY_STEP, PLAIN_TEXT, and BDD support",
   "type": "module",
   "main": "./build/index.js",
@@ -22,6 +22,7 @@
     "test": "node test/run-tests.cjs",
     "test:unit": "node test/zephyr-server.test.cjs",
     "test:integration": "node test/integration.test.cjs",
+    "report:weekly": "node scripts/weekly-report.cjs",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/src/index.ts

@@ -25,7 +25,7 @@ class ZephyrServer {
     this.server = new Server(
       {
         name: 'zephyr-server',
-        version: '0.3.0',
+        version: '0.3.1',
       },
       {
         capabilities: {
@@ -75,6 +75,8 @@ class ZephyrServer {
             return await this.toolHandlers.getTestRunCases(args);
           case 'delete_test_case':
             return await this.toolHandlers.deleteTestCase(args);
+          case 'delete_test_run':
+            return await this.toolHandlers.deleteTestRun(args);
           case 'create_test_run':
             return await this.toolHandlers.createTestRun(args as any);
           case 'get_test_run':

package/src/tool-handlers.ts

@@ -301,6 +301,25 @@ export class ZephyrToolHandlers {
     }
   }
 
+  async deleteTestRun(args: any) {
+    const { test_run_key } = args;
+    try {
+      const response = await this.axiosInstance.delete(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`);
+      if (response.status === 204) {
+        return {
+          content: [{ type: 'text', text: `Test run ${test_run_key} deleted successfully.` }],
+        };
+      } else {
+        return {
+          content: [{ type: 'text', text: `Failed to delete test run. Status: ${response.status}` }],
+          isError: true,
+        };
+      }
+    } catch (error) {
+      throw new McpError(ErrorCode.InternalError, `Failed to delete test run: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
   async createTestRun(args: TestRunArgs) {
     const {
       project_key,
@@ -611,49 +630,23 @@ export class ZephyrToolHandlers {
   async addTestCasesToRun(args: AddTestCasesToRunArgs) {
     const { test_run_key, test_case_keys } = args;
 
+    if (this.jiraConfig.type === 'datacenter') {
+      throw new McpError(
+        ErrorCode.InvalidRequest,
+        'add_test_cases_to_run is only supported on Zephyr Scale Cloud. The Data Center API (v1) does not provide an endpoint to modify test runs after creation.'
+      );
+    }
+
     try {
-      // For Data Center, we need to get the current items and then update
-      if (this.jiraConfig.type === 'datacenter') {
-        const getResponse = await this.axiosInstance.get(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`);
-        const existingItems = getResponse.data.items || [];
-        const existingKeys = new Set(existingItems.map((item: any) => item.testCaseKey));
-
-        const newItems = test_case_keys
-          .filter(key => !existingKeys.has(key))
-          .map(key => ({ testCaseKey: key, testResultStatus: 'Not Executed' }));
-
-        if (newItems.length > 0) {
-          let response;
-          if (this.jiraConfig.type === 'datacenter') {
-            const minimalPayload = {
-              items: [...existingItems, ...newItems]
-            };
-            response = await this.axiosInstance.put(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`, minimalPayload);
-          } else {
-            const postPayload = { items: newItems.map(item => item.testCaseKey) };
-            response = await this.axiosInstance.post(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}/testcases`, postPayload);
-          }
+      const payload = {
+        items: test_case_keys.map(key => ({ testCaseKey: key }))
+      };
+      const response = await this.axiosInstance.post(`/testcycles/${test_run_key}/testcases`, payload);
 
-          if (response.status === 200 || response.status === 201 || response.status === 204) {
-            return {
-              content: [{ type: 'text', text: `Added ${newItems.length} new test cases to test run ${test_run_key}.` }],
-            };
-          }
-        } else {
-          return {
-            content: [{ type: 'text', text: 'All specified test cases are already in the test run.' }],
-          };
-        }
-      } else {
-        // For Cloud, we can just post the new test case keys
-        const fullPayload = { items: test_case_keys };
-        const response = await this.axiosInstance.put(`${this.jiraConfig.apiEndpoints.testrun}/${test_run_key}`, fullPayload);
-
-        if (response.status === 200 || response.status === 204) {
-          return {
-            content: [{ type: 'text', text: `Successfully updated test cases for test run ${test_run_key}.` }],
-          };
-        }
+      if (response.status === 200 || response.status === 201 || response.status === 204) {
+        return {
+          content: [{ type: 'text', text: `Added ${test_case_keys.length} test case(s) to test run ${test_run_key}.` }],
+        };
       }
     } catch (error) {
       throw new McpError(ErrorCode.InternalError, `Failed to add test cases: ${error instanceof Error ? error.message : String(error)}`);

package/src/tool-schemas.ts

@@ -373,9 +373,23 @@ export const toolSchemas = [
       },
     },
   },
+  {
+    name: 'delete_test_run',
+    description: 'Delete a specific test run',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        test_run_key: {
+          type: 'string',
+          description: 'Test run key to delete (e.g., PROJ-R123)',
+        },
+      },
+      required: ['test_run_key'],
+    },
+  },
   {
     name: 'add_test_cases_to_run',
-    description: 'Add test cases to an existing test run',
+    description: 'Add test cases to an existing test run (Cloud only — not supported on Data Center)',
     inputSchema: {
       type: 'object',
       properties: {