@azure-devops/mcp 2.5.0 → 2.6.0-nightly.20260419

package/dist/tools/search.js

@@ -12,13 +12,16 @@ const SEARCH_TOOLS = {
 function configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(SEARCH_TOOLS.search_code, "Search Azure DevOps Repositories for a given search text", {
         searchText: z.string().describe("Keywords to search for in code repositories"),
-        project: z.array(z.string()).optional().describe("Filter by projects"),
+        project: z
+            .union([z.string().transform((value) => [value]), z.array(z.string())])
+            .optional()
+            .describe("Filter by projects"),
         repository: z.array(z.string()).optional().describe("Filter by repositories"),
         path: z.array(z.string()).optional().describe("Filter by paths"),
         branch: z.array(z.string()).optional().describe("Filter by branches"),
         includeFacets: z.boolean().default(false).describe("Include facets in the search results"),
-        skip: z.number().default(0).describe("Number of results to skip"),
-        top: z.number().default(5).describe("Maximum number of results to return"),
+        skip: z.coerce.number().default(0).describe("Number of results to skip"),
+        top: z.coerce.number().default(5).describe("Maximum number of results to return"),
     }, async ({ searchText, project, repository, path, branch, includeFacets, skip, top }) => {
         const accessToken = await tokenProvider();
         const connection = await connectionProvider();
@@ -66,8 +69,8 @@ function configureSearchTools(server, tokenProvider, connectionProvider, userAge
         project: z.array(z.string()).optional().describe("Filter by projects"),
         wiki: z.array(z.string()).optional().describe("Filter by wiki names"),
         includeFacets: z.boolean().default(false).describe("Include facets in the search results"),
-        skip: z.number().default(0).describe("Number of results to skip"),
-        top: z.number().default(10).describe("Maximum number of results to return"),
+        skip: z.coerce.number().default(0).describe("Number of results to skip"),
+        top: z.coerce.number().default(10).describe("Maximum number of results to return"),
     }, async ({ searchText, project, wiki, includeFacets, skip, top }) => {
         const accessToken = await tokenProvider();
         const url = `https://almsearch.dev.azure.com/${orgName}/_apis/search/wikisearchresults?api-version=${apiVersion}`;
@@ -110,8 +113,8 @@ function configureSearchTools(server, tokenProvider, connectionProvider, userAge
         state: z.array(z.string()).optional().describe("Filter by work item states"),
         assignedTo: z.array(z.string()).optional().describe("Filter by assigned to users"),
         includeFacets: z.boolean().default(false).describe("Include facets in the search results"),
-        skip: z.number().default(0).describe("Number of results to skip for pagination"),
-        top: z.number().default(10).describe("Number of results to return"),
+        skip: z.coerce.number().default(0).describe("Number of results to skip for pagination"),
+        top: z.coerce.number().default(10).describe("Number of results to return"),
     }, async ({ searchText, project, areaPath, workItemType, state, assignedTo, includeFacets, skip, top }) => {
         const accessToken = await tokenProvider();
         const url = `https://almsearch.dev.azure.com/${orgName}/_apis/search/workitemsearchresults?api-version=${apiVersion}`;

package/dist/tools/test-plans.js

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { SuiteExpand } from "azure-devops-node-api/interfaces/TestPlanInterfaces.js";
 import { z } from "zod";
+import { apiVersion } from "../utils.js";
 const Test_Plan_Tools = {
     create_test_plan: "testplan_create_test_plan",
     create_test_case: "testplan_create_test_case",
@@ -13,7 +13,7 @@ const Test_Plan_Tools = {
     list_test_suites: "testplan_list_test_suites",
     create_test_suite: "testplan_create_test_suite",
 };
-function configureTestPlanTools(server, _, connectionProvider) {
+function configureTestPlanTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     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."),
@@ -21,12 +21,42 @@ function configureTestPlanTools(server, _, connectionProvider) {
         continuationToken: z.string().optional().describe("Token to continue fetching test plans from a previous request."),
     }, async ({ project, filterActivePlans, includePlanDetails, continuationToken }) => {
         try {
-            const owner = ""; //making owner an empty string untill we can figure out how to get owner id
             const connection = await connectionProvider();
-            const testPlanApi = await connection.getTestPlanApi();
-            const testPlans = await testPlanApi.getTestPlans(project, owner, continuationToken, includePlanDetails, filterActivePlans);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": apiVersion });
+            if (filterActivePlans)
+                params.append("filterActivePlans", "true");
+            if (includePlanDetails)
+                params.append("includePlanDetails", "true");
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test plans (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testPlans = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
+            const result = {
+                testPlans: testPlans,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
-                content: [{ type: "text", text: JSON.stringify(testPlans, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
@@ -72,8 +102,8 @@ function configureTestPlanTools(server, _, connectionProvider) {
     });
     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"),
-        parentSuiteId: z.number().describe("ID of the parent suite under which the new suite will be created, if not given by user this can be id of a root suite of the test plan"),
+        planId: z.coerce.number().min(1).describe("ID of the test plan that contains the suites"),
+        parentSuiteId: z.coerce.number().min(1).describe("ID of the parent suite under which the new suite will be created, if not given by user this can be id of a root suite of the test plan"),
         name: z.string().describe("Name of the child test suite"),
     }, async ({ project, planId, parentSuiteId, name }) => {
         const maxRetries = 5;
@@ -120,8 +150,8 @@ function configureTestPlanTools(server, _, connectionProvider) {
     });
     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."),
-        suiteId: z.number().describe("The ID of the test suite."),
+        planId: z.coerce.number().min(1).describe("The ID of the test plan."),
+        suiteId: z.coerce.number().min(1).describe("The ID of the test suite."),
         testCaseIds: z.string().or(z.array(z.string())).describe("The ID(s) of the test case(s) to add. "),
     }, async ({ project, planId, suiteId, testCaseIds }) => {
         try {
@@ -149,10 +179,10 @@ function configureTestPlanTools(server, _, connectionProvider) {
             .string()
             .optional()
             .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."),
-        priority: z.number().optional().describe("The priority of the test case."),
+        priority: z.coerce.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."),
-        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."),
+        testsWorkItemId: z.coerce.number().min(1).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 }) => {
         try {
             const connection = await connectionProvider();
@@ -220,7 +250,7 @@ function configureTestPlanTools(server, _, connectionProvider) {
         }
     });
     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."),
+        id: z.coerce.number().min(1).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."),
@@ -256,15 +286,43 @@ function configureTestPlanTools(server, _, connectionProvider) {
     });
     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."),
-        suiteid: z.number().describe("The ID of the test suite."),
-    }, async ({ project, planid, suiteid }) => {
+        planid: z.coerce.number().min(1).describe("The ID of the test plan."),
+        suiteid: z.coerce.number().min(1).describe("The ID of the test suite."),
+        continuationToken: z.string().optional().describe("Token to continue fetching test cases from a previous request."),
+    }, async ({ project, planid, suiteid, continuationToken }) => {
         try {
             const connection = await connectionProvider();
-            const coreApi = await connection.getTestPlanApi();
-            const testcases = await coreApi.getTestCaseList(project, planid, suiteid);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": "7.2-preview.3" });
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans/${planid}/Suites/${suiteid}/TestCase?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test cases (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testcases = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
+            const result = {
+                testCases: testcases,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
-                content: [{ type: "text", text: JSON.stringify(testcases, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
@@ -277,7 +335,7 @@ function configureTestPlanTools(server, _, connectionProvider) {
     });
     server.tool(Test_Plan_Tools.test_results_from_build_id, "Gets a list of test results for a given project and build ID. Can filter by test outcome (e.g. Failed, Passed, Aborted). Returns test case titles, error messages, stack traces, and outcomes. Efficiently handles builds with large numbers of test runs.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
-        buildid: z.number().describe("The ID of the build."),
+        buildid: z.coerce.number().min(1).describe("The ID of the build."),
         outcomes: z.array(z.string()).optional().describe("Filter results by test outcome, e.g. ['Failed', 'Passed', 'Aborted']."),
     }, async ({ project, buildid, outcomes }) => {
         try {
@@ -329,14 +387,34 @@ function configureTestPlanTools(server, _, connectionProvider) {
     });
     server.tool(Test_Plan_Tools.list_test_suites, "Retrieve a paginated list of test suites from an Azure DevOps project and Test Plan Id.", {
         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."),
+        planId: z.coerce.number().min(1).describe("The ID of the test plan."),
         continuationToken: z.string().optional().describe("Token to continue fetching test plans from a previous request."),
     }, async ({ project, planId, continuationToken }) => {
         try {
             const connection = await connectionProvider();
-            const testPlanApi = await connection.getTestPlanApi();
-            const expand = SuiteExpand.Children;
-            const testSuites = await testPlanApi.getTestSuitesForPlan(project, planId, expand, continuationToken);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": apiVersion, "expand": "children" });
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans/${planId}/Suites?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test suites (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testSuites = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
             // The API returns a flat list where the root suite is first, followed by all nested suites
             // We need to build a proper hierarchy by creating a map and assembling the tree
             // Create a map of all suites by ID for quick lookup
@@ -373,7 +451,13 @@ function configureTestPlanTools(server, _, connectionProvider) {
                 }
                 return cleaned;
             };
-            const result = roots.map((root) => cleanSuite(root));
+            const cleanedSuites = roots.map((root) => cleanSuite(root));
+            const result = {
+                testSuites: cleanedSuites,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };

package/dist/tools/wiki.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { apiVersion } from "../utils.js";
+import { createExternalContentResponse } from "../shared/content-safety.js";
 const WIKI_TOOLS = {
     list_wikis: "wiki_list_wikis",
     get_wiki: "wiki_get_wiki",
@@ -59,9 +60,9 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
     server.tool(WIKI_TOOLS.list_wiki_pages, "Retrieve a list of wiki pages for a specific wiki and project.", {
         wikiIdentifier: z.string().describe("The unique identifier of the wiki."),
         project: z.string().describe("The project name or ID where the wiki is located."),
-        top: z.number().default(20).describe("The maximum number of pages to return. Defaults to 20."),
+        top: z.coerce.number().default(20).describe("The maximum number of pages to return. Defaults to 20."),
         continuationToken: z.string().optional().describe("Token for pagination to retrieve the next set of pages."),
-        pageViewsForDays: z.number().optional().describe("Number of days to retrieve page views for. If not specified, page views are not included."),
+        pageViewsForDays: z.coerce.number().optional().describe("Number of days to retrieve page views for. If not specified, page views are not included."),
     }, async ({ wikiIdentifier, project, top = 20, continuationToken, pageViewsForDays }) => {
         try {
             const connection = await connectionProvider();
@@ -111,7 +112,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
             if (recursionLevel) {
                 params.append("recursionLevel", recursionLevel);
             }
-            const url = `${baseUrl}/${project}/_apis/wiki/wikis/${wikiIdentifier}/pages?${params.toString()}`;
+            const url = `${baseUrl}/${encodeURIComponent(project)}/_apis/wiki/wikis/${encodeURIComponent(wikiIdentifier)}/pages?${params.toString()}`;
             const response = await fetch(url, {
                 headers: {
                     "Authorization": `Bearer ${accessToken}`,
@@ -173,7 +174,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
                     try {
                         const accessToken = await tokenProvider();
                         const baseUrl = connection.serverUrl.replace(/\/$/, "");
-                        const restUrl = `${baseUrl}/${resolvedProject}/_apis/wiki/wikis/${resolvedWiki}/pages/${parsed.pageId}?includeContent=true&api-version=7.1`;
+                        const restUrl = `${baseUrl}/${encodeURIComponent(resolvedProject)}/_apis/wiki/wikis/${encodeURIComponent(resolvedWiki)}/pages/${parsed.pageId}?includeContent=true&api-version=7.1`;
                         const resp = await fetch(restUrl, {
                             headers: {
                                 "Authorization": `Bearer ${accessToken}`,
@@ -209,7 +210,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
                 }
                 pageContent = await streamToString(stream);
             }
-            return { content: [{ type: "text", text: JSON.stringify(pageContent, null, 2) }] };
+            return createExternalContentResponse(pageContent, "wiki page");
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
@@ -236,7 +237,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
             // Build the URL for the wiki page API with version descriptor
             const baseUrl = connection.serverUrl;
             const projectParam = project || "";
-            const url = `${baseUrl}/${projectParam}/_apis/wiki/wikis/${wikiIdentifier}/pages?path=${encodedPath}&versionDescriptor.versionType=branch&versionDescriptor.version=${encodeURIComponent(branch)}&api-version=7.1`;
+            const url = `${baseUrl}/${encodeURIComponent(projectParam)}/_apis/wiki/wikis/${encodeURIComponent(wikiIdentifier)}/pages?path=${encodedPath}&versionDescriptor.versionType=branch&versionDescriptor.version=${encodeURIComponent(branch)}&api-version=7.1`;
             // First, try to create a new page (PUT without ETag)
             try {
                 const createResponse = await fetch(url, {