@azure-devops/mcp 1.0.0 → 1.2.0-daily.20250715

package/dist/tools/testplans.js

@@ -7,7 +7,7 @@ const Test_Plan_Tools = {
     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",
-    list_test_plans: "testplan_list_test_plans"
+    list_test_plans: "testplan_list_test_plans",
 };
 function configureTestPlanTools(server, tokenProvider, connectionProvider) {
     /*
@@ -19,7 +19,7 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
         filterActivePlans: z.boolean().default(true).describe("Filter to include only active test plans. Defaults to true."),
         includePlanDetails: z.boolean().default(false).describe("Include detailed information about each test plan."),
         continuationToken: z.string().optional().describe("Token to continue fetching test plans from a previous request."),
-    }, async ({ project, filterActivePlans, includePlanDetails, continuationToken, }) => {
+    }, async ({ project, filterActivePlans, includePlanDetails, continuationToken }) => {
         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();
@@ -39,7 +39,7 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
         startDate: z.string().optional().describe("The start date of the test plan"),
         endDate: z.string().optional().describe("The end date of the test plan"),
         areaPath: z.string().optional().describe("The area path for the test plan"),
-    }, async ({ project, name, iteration, description, startDate, endDate, areaPath, }) => {
+    }, async ({ project, name, iteration, description, startDate, endDate, areaPath }) => {
         const connection = await connectionProvider();
         const testPlanApi = await connection.getTestPlanApi();
         const testPlanToCreate = {
@@ -52,9 +52,7 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
         };
         const createdTestPlan = await testPlanApi.createTestPlan(testPlanToCreate, project);
         return {
-            content: [
-                { type: "text", text: JSON.stringify(createdTestPlan, null, 2) },
-            ],
+            content: [{ type: "text", text: JSON.stringify(createdTestPlan, null, 2) }],
         };
     });
     /*
@@ -69,14 +67,10 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
         const connection = await connectionProvider();
         const testApi = await connection.getTestApi();
         // If testCaseIds is an array, convert it to comma-separated string
-        const testCaseIdsString = Array.isArray(testCaseIds)
-            ? testCaseIds.join(",")
-            : testCaseIds;
+        const testCaseIdsString = Array.isArray(testCaseIds) ? testCaseIds.join(",") : testCaseIds;
         const addedTestCases = await testApi.addTestCasesToSuite(project, planId, suiteId, testCaseIdsString);
         return {
-            content: [
-                { type: "text", text: JSON.stringify(addedTestCases, null, 2) },
-            ],
+            content: [{ type: "text", text: JSON.stringify(addedTestCases, null, 2) }],
         };
     });
     /*
@@ -169,7 +163,7 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
 }
 /*
  * Helper function to convert steps text to XML format required
-*/
+ */
 function convertStepsToXml(steps) {
     const stepsLines = steps.split("\n").filter((line) => line.trim() !== "");
     let xmlSteps = `<steps id="0" last="${stepsLines.length}">`;
@@ -178,10 +172,10 @@ function convertStepsToXml(steps) {
         if (stepLine) {
             const stepMatch = stepLine.match(/^(\d+)\.\s*(.+)$/);
             const stepText = stepMatch ? stepMatch[2] : stepLine;
-            xmlSteps += `
-                <step id="${i + 1}" type="ActionStep">
-                    <parameterizedString isformatted="true">${escapeXml(stepText)}</parameterizedString>
-                    <parameterizedString isformatted="true">Verify step completes successfully</parameterizedString>
+            xmlSteps += `
+                <step id="${i + 1}" type="ActionStep">
+                    <parameterizedString isformatted="true">${escapeXml(stepText)}</parameterizedString>
+                    <parameterizedString isformatted="true">Verify step completes successfully</parameterizedString>
                 </step>`;
         }
     }
@@ -190,7 +184,7 @@ function convertStepsToXml(steps) {
 }
 /*
  * Helper function to escape XML special characters
-*/
+ */
 function escapeXml(unsafe) {
     return unsafe.replace(/[<>&'"]/g, (c) => {
         switch (c) {

package/dist/tools/wiki.js

@@ -12,22 +12,46 @@ function configureWikiTools(server, tokenProvider, connectionProvider) {
         wikiIdentifier: z.string().describe("The unique identifier of the wiki."),
         project: z.string().optional().describe("The project name or ID where the wiki is located. If not provided, the default project will be used."),
     }, async ({ wikiIdentifier, project }) => {
-        const connection = await connectionProvider();
-        const wikiApi = await connection.getWikiApi();
-        const wiki = await wikiApi.getWiki(wikiIdentifier, project);
-        return {
-            content: [{ type: "text", text: JSON.stringify(wiki, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const wikiApi = await connection.getWikiApi();
+            const wiki = await wikiApi.getWiki(wikiIdentifier, project);
+            if (!wiki) {
+                return { content: [{ type: "text", text: "No wiki found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(wiki, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching wiki: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
     server.tool(WIKI_TOOLS.list_wikis, "Retrieve a list of wikis for an organization or project.", {
         project: z.string().optional().describe("The project name or ID to filter wikis. If not provided, all wikis in the organization will be returned."),
     }, async ({ project }) => {
-        const connection = await connectionProvider();
-        const wikiApi = await connection.getWikiApi();
-        const wikis = await wikiApi.getAllWikis(project);
-        return {
-            content: [{ type: "text", text: JSON.stringify(wikis, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const wikiApi = await connection.getWikiApi();
+            const wikis = await wikiApi.getAllWikis(project);
+            if (!wikis) {
+                return { content: [{ type: "text", text: "No wikis found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(wikis, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching wikis: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
     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."),
@@ -35,31 +59,55 @@ function configureWikiTools(server, tokenProvider, connectionProvider) {
         top: z.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."),
-    }, async ({ wikiIdentifier, project, top = 20, continuationToken, pageViewsForDays, }) => {
-        const connection = await connectionProvider();
-        const wikiApi = await connection.getWikiApi();
-        const pagesBatchRequest = {
-            top,
-            continuationToken,
-            pageViewsForDays,
-        };
-        const pages = await wikiApi.getPagesBatch(pagesBatchRequest, project, wikiIdentifier);
-        return {
-            content: [{ type: "text", text: JSON.stringify(pages, null, 2) }],
-        };
+    }, async ({ wikiIdentifier, project, top = 20, continuationToken, pageViewsForDays }) => {
+        try {
+            const connection = await connectionProvider();
+            const wikiApi = await connection.getWikiApi();
+            const pagesBatchRequest = {
+                top,
+                continuationToken,
+                pageViewsForDays,
+            };
+            const pages = await wikiApi.getPagesBatch(pagesBatchRequest, project, wikiIdentifier);
+            if (!pages) {
+                return { content: [{ type: "text", text: "No wiki pages found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(pages, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching wiki pages: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
     server.tool(WIKI_TOOLS.get_wiki_page_content, "Retrieve wiki page content by wikiIdentifier and path.", {
         wikiIdentifier: z.string().describe("The unique identifier of the wiki."),
         project: z.string().describe("The project name or ID where the wiki is located."),
         path: z.string().describe("The path of the wiki page to retrieve content for."),
     }, async ({ wikiIdentifier, project, path }) => {
-        const connection = await connectionProvider();
-        const wikiApi = await connection.getWikiApi();
-        const stream = await wikiApi.getPageText(project, wikiIdentifier, path, undefined, undefined, true);
-        const content = await streamToString(stream);
-        return {
-            content: [{ type: "text", text: JSON.stringify(content, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const wikiApi = await connection.getWikiApi();
+            const stream = await wikiApi.getPageText(project, wikiIdentifier, path, undefined, undefined, true);
+            if (!stream) {
+                return { content: [{ type: "text", text: "No wiki page content found" }], isError: true };
+            }
+            const content = await streamToString(stream);
+            return {
+                content: [{ type: "text", text: JSON.stringify(content, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching wiki page content: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
 }
 function streamToString(stream) {

package/dist/tools/work.js

@@ -25,20 +25,22 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
             return {
                 content: [{ type: "text", text: `Error fetching team iterations: ${errorMessage}` }],
-                isError: true
+                isError: true,
             };
         }
     });
     server.tool(WORK_TOOLS.create_iterations, "Create new iterations in a specified Azure DevOps project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
-        iterations: z.array(z.object({
+        iterations: z
+            .array(z.object({
             iterationName: z.string().describe("The name of the iteration to create."),
             startDate: z.string().optional().describe("The start date of the iteration in ISO format (e.g., '2023-01-01T00:00:00Z'). Optional."),
-            finishDate: z.string().optional().describe("The finish date of the iteration in ISO format (e.g., '2023-01-31T23:59:59Z'). Optional.")
-        })).describe("An array of iterations to create. Each iteration must have a name and can optionally have start and finish dates in ISO format.")
+            finishDate: z.string().optional().describe("The finish date of the iteration in ISO format (e.g., '2023-01-31T23:59:59Z'). Optional."),
+        }))
+            .describe("An array of iterations to create. Each iteration must have a name and can optionally have start and finish dates in ISO format."),
     }, async ({ project, iterations }) => {
         try {
             const connection = await connectionProvider();
@@ -65,20 +67,22 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
             return {
                 content: [{ type: "text", text: `Error creating iterations: ${errorMessage}` }],
-                isError: true
+                isError: true,
             };
         }
     });
     server.tool(WORK_TOOLS.assign_iterations, "Assign existing iterations to a specific team in a project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
         team: z.string().describe("The name or ID of the Azure DevOps team."),
-        iterations: z.array(z.object({
+        iterations: z
+            .array(z.object({
             identifier: z.string().describe("The identifier of the iteration to assign."),
-            path: z.string().describe("The path of the iteration to assign, e.g., 'Project/Iteration'.")
-        })).describe("An array of iterations to assign. Each iteration must have an identifier and a path."),
+            path: z.string().describe("The path of the iteration to assign, e.g., 'Project/Iteration'."),
+        }))
+            .describe("An array of iterations to assign. Each iteration must have an identifier and a path."),
     }, async ({ project, team, iterations }) => {
         try {
             const connection = await connectionProvider();
@@ -99,10 +103,10 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
             return {
                 content: [{ type: "text", text: `Error assigning iterations: ${errorMessage}` }],
-                isError: true
+                isError: true,
             };
         }
     });