@azure-devops/mcp 0.1.0 → 1.1.0

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

@@ -13,58 +13,102 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
         team: z.string().describe("The name or ID of the Azure DevOps team."),
         timeframe: z.enum(["current"]).optional().describe("The timeframe for which to retrieve iterations. Currently, only 'current' is supported."),
     }, async ({ project, team, timeframe }) => {
-        const connection = await connectionProvider();
-        const workApi = await connection.getWorkApi();
-        const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
-        return {
-            content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
+            if (!iterations) {
+                return { content: [{ type: "text", text: "No iterations found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching team iterations: ${errorMessage}` }],
+                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 }) => {
-        const connection = await connectionProvider();
-        const workItemTrackingApi = await connection.getWorkItemTrackingApi();
-        const results = [];
-        for (const { iterationName, startDate, finishDate } of iterations) {
-            // Step 1: Create the iteration
-            const iteration = await workItemTrackingApi.createOrUpdateClassificationNode({
-                name: iterationName,
-                attributes: {
-                    startDate: startDate ? new Date(startDate) : undefined,
-                    finishDate: finishDate ? new Date(finishDate) : undefined,
-                },
-            }, project, TreeStructureGroup.Iterations);
-            results.push(iteration);
+        try {
+            const connection = await connectionProvider();
+            const workItemTrackingApi = await connection.getWorkItemTrackingApi();
+            const results = [];
+            for (const { iterationName, startDate, finishDate } of iterations) {
+                // Step 1: Create the iteration
+                const iteration = await workItemTrackingApi.createOrUpdateClassificationNode({
+                    name: iterationName,
+                    attributes: {
+                        startDate: startDate ? new Date(startDate) : undefined,
+                        finishDate: finishDate ? new Date(finishDate) : undefined,
+                    },
+                }, project, TreeStructureGroup.Iterations);
+                if (iteration) {
+                    results.push(iteration);
+                }
+            }
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: "No iterations were created" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error creating iterations: ${errorMessage}` }],
+                isError: true,
+            };
         }
-        return {
-            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-        };
     });
     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 }) => {
-        const connection = await connectionProvider();
-        const workApi = await connection.getWorkApi();
-        const teamContext = { project, team };
-        const results = [];
-        for (const { identifier, path } of iterations) {
-            const assignment = await workApi.postTeamIteration({ path: path, id: identifier }, teamContext);
-            results.push(assignment);
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const teamContext = { project, team };
+            const results = [];
+            for (const { identifier, path } of iterations) {
+                const assignment = await workApi.postTeamIteration({ path: path, id: identifier }, teamContext);
+                if (assignment) {
+                    results.push(assignment);
+                }
+            }
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: "No iterations were assigned to the team" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error assigning iterations: ${errorMessage}` }],
+                isError: true,
+            };
         }
-        return {
-            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-        };
     });
 }
 export { WORK_TOOLS, configureWorkTools };