@azure-devops/mcp 2.2.0-nightly.20251013 → 2.2.1-nightly.20251014

package/README.md

@@ -122,6 +122,7 @@ Interact with these Azure DevOps services:
 
 - **testplan_create_test_plan**: Create a new test plan in the project.
 - **testplan_create_test_case**: Create a new test case work item.
+- **testplan_update_test_case_steps**: Update an existing test case work item's steps.
 - **testplan_add_test_cases_to_suite**: Add existing test cases to a test suite.
 - **testplan_list_test_plans**: Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.
 - **testplan_list_test_cases**: Get a list of test cases in the test plan.

package/dist/auth.js

@@ -5,14 +5,19 @@ const scopes = ["499b84ac-1321-427f-aa17-267ca6975798/.default"];
 class OAuthAuthenticator {
     static clientId = "0d50963b-7bb9-4fe7-94c7-a99af00b5136";
     static defaultAuthority = "https://login.microsoftonline.com/common";
+    static zeroTenantId = "00000000-0000-0000-0000-000000000000";
     accountId;
     publicClientApp;
     constructor(tenantId) {
         this.accountId = null;
+        let authority = OAuthAuthenticator.defaultAuthority;
+        if (tenantId && tenantId !== OAuthAuthenticator.zeroTenantId) {
+            authority = `https://login.microsoftonline.com/${tenantId}`;
+        }
         this.publicClientApp = new PublicClientApplication({
             auth: {
                 clientId: OAuthAuthenticator.clientId,
-                authority: tenantId ? `https://login.microsoftonline.com/${tenantId}` : OAuthAuthenticator.defaultAuthority,
+                authority,
             },
         });
     }

package/dist/tools/test-plans.js

@@ -4,6 +4,7 @@ import { z } from "zod";
 const Test_Plan_Tools = {
     create_test_plan: "testplan_create_test_plan",
     create_test_case: "testplan_create_test_case",
+    update_test_case_steps: "testplan_update_test_case_steps",
     add_test_cases_to_suite: "testplan_add_test_cases_to_suite",
     test_results_from_build_id: "testplan_show_test_results_from_build_id",
     list_test_cases: "testplan_list_test_cases",
@@ -11,10 +12,6 @@ const Test_Plan_Tools = {
     create_test_suite: "testplan_create_test_suite",
 };
 function configureTestPlanTools(server, _, connectionProvider) {
-    /*
-      LIST OF TEST PLANS
-      get list of test plans by project
-    */
     server.tool(Test_Plan_Tools.list_test_plans, "Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         filterActivePlans: z.boolean().default(true).describe("Filter to include only active test plans. Defaults to true."),
@@ -29,9 +26,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(testPlans, null, 2) }],
         };
     });
-    /*
-      Create Test Plan - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_plan, "Creates a new test plan in the project.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project where the test plan will be created."),
         name: z.string().describe("The name of the test plan to be created."),
@@ -56,9 +50,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(createdTestPlan, null, 2) }],
         };
     });
-    /*
-      Create Test Suite - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_suite, "Creates a new test suite in a test plan.", {
         project: z.string().describe("Project ID or project name"),
         planId: z.number().describe("ID of the test plan that contains the suites"),
@@ -80,9 +71,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(createdTestSuite, null, 2) }],
         };
     });
-    /*
-      Add Test Cases to Suite - ADD
-    */
     server.tool(Test_Plan_Tools.add_test_cases_to_suite, "Adds existing test cases to a test suite.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         planId: z.number().describe("The ID of the test plan."),
@@ -98,9 +86,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(addedTestCases, null, 2) }],
         };
     });
-    /*
-      Create Test Case - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_case, "Creates a new test case work item.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         title: z.string().describe("The title of the test case."),
@@ -111,7 +96,8 @@ function configureTestPlanTools(server, _, connectionProvider) {
         priority: z.number().optional().describe("The priority of the test case."),
         areaPath: z.string().optional().describe("The area path for the test case."),
         iterationPath: z.string().optional().describe("The iteration path for the test case."),
-    }, async ({ project, title, steps, priority, areaPath, iterationPath }) => {
+        testsWorkItemId: z.number().optional().describe("Optional work item id that will be set as a Microsoft.VSTS.Common.TestedBy-Reverse link to the test case."),
+    }, async ({ project, title, steps, priority, areaPath, iterationPath, testsWorkItemId }) => {
         const connection = await connectionProvider();
         const witClient = await connection.getWorkItemTrackingApi();
         let stepsXml;
@@ -125,6 +111,16 @@ function configureTestPlanTools(server, _, connectionProvider) {
             path: "/fields/System.Title",
             value: title,
         });
+        if (testsWorkItemId) {
+            patchDocument.push({
+                op: "add",
+                path: "/relations/-",
+                value: {
+                    rel: "Microsoft.VSTS.Common.TestedBy-Reverse",
+                    url: `${connection.serverUrl}/${project}/_apis/wit/workItems/${testsWorkItemId}`,
+                },
+            });
+        }
         if (stepsXml) {
             patchDocument.push({
                 op: "add",
@@ -158,10 +154,32 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(workItem, null, 2) }],
         };
     });
-    /*
-      TEST PLANS
-      Gets a list of test cases for a given testplan.
-    */
+    server.tool(Test_Plan_Tools.update_test_case_steps, "Update an existing test case work item.", {
+        id: z.number().describe("The ID of the test case work item to update."),
+        steps: z
+            .string()
+            .describe("The steps to reproduce the test case. Make sure to format each step as '1. Step one|Expected result one\n2. Step two|Expected result two. USE '|' as the delimiter between step and expected result. DO NOT use '|' in the description of the step or expected result."),
+    }, async ({ id, steps }) => {
+        const connection = await connectionProvider();
+        const witClient = await connection.getWorkItemTrackingApi();
+        let stepsXml;
+        if (steps) {
+            stepsXml = convertStepsToXml(steps);
+        }
+        // Create JSON patch document for work item
+        const patchDocument = [];
+        if (stepsXml) {
+            patchDocument.push({
+                op: "add",
+                path: "/fields/Microsoft.VSTS.TCM.Steps",
+                value: stepsXml,
+            });
+        }
+        const workItem = await witClient.updateWorkItem({}, patchDocument, id);
+        return {
+            content: [{ type: "text", text: JSON.stringify(workItem, null, 2) }],
+        };
+    });
     server.tool(Test_Plan_Tools.list_test_cases, "Gets a list of test cases in the test plan.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         planid: z.number().describe("The ID of the test plan."),
@@ -174,9 +192,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(testcases, null, 2) }],
         };
     });
-    /*
-      Gets a list of test results for a given project and build ID
-    */
     server.tool(Test_Plan_Tools.test_results_from_build_id, "Gets a list of test results for a given project and build ID.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         buildid: z.number().describe("The ID of the build."),

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.2.0-nightly.20251013";
+export const packageVersion = "2.2.1-nightly.20251014";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.2.0-nightly.20251013",
+  "version": "2.2.1-nightly.20251014",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",