@azure-devops/mcp 2.4.0-nightly.20260222 → 2.4.0-nightly.20260224

package/dist/tools/repositories.js

@@ -1,6 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, GitPullRequestMergeStrategy, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
+import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, GitPullRequestMergeStrategy, VersionControlRecursionType, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
 import { z } from "zod";
 import { getCurrentUserDetails, getUserIdFromEmail } from "./auth.js";
 import { getEnumKeys } from "../utils.js";
@@ -23,6 +23,8 @@ const REPO_TOOLS = {
     update_pull_request_thread: "repo_update_pull_request_thread",
     search_commits: "repo_search_commits",
     list_pull_requests_by_commits: "repo_list_pull_requests_by_commits",
+    vote_pull_request: "repo_vote_pull_request",
+    list_directory: "repo_list_directory",
 };
 function branchesFilterOutIrrelevantProperties(branches, top) {
     return branches
@@ -103,6 +105,21 @@ function trimPullRequest(pr, includeDescription = false) {
         project: pr.repository?.project?.name,
     };
 }
+// Helper function to build a version descriptor from branch or commit
+function buildVersionDescriptor(version, versionType) {
+    if (!version) {
+        return undefined;
+    }
+    const versionTypeMap = {
+        Branch: GitVersionType.Branch,
+        Commit: GitVersionType.Commit,
+        Tag: GitVersionType.Tag,
+    };
+    return {
+        version: version,
+        versionType: versionTypeMap[versionType || "Branch"] ?? GitVersionType.Branch,
+    };
+}
 function configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(REPO_TOOLS.create_pull_request, "Create a new pull request.", {
         repositoryId: z.string().describe("The ID of the repository where the pull request will be created."),
@@ -1150,5 +1167,100 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             };
         }
     });
+    server.tool(REPO_TOOLS.vote_pull_request, "Cast a vote on a pull request. Automatically adds the current user as a reviewer if they are not already one.", {
+        repositoryId: z.string().describe("The ID of the repository."),
+        pullRequestId: z.number().describe("The ID of the pull request."),
+        vote: z.enum(["Approved", "ApprovedWithSuggestions", "NoVote", "WaitingForAuthor", "Rejected"]).describe("The vote to cast: Approved(10), Suggestions(5), None(0), Waiting(-5), Rejected(-10)."),
+    }, async ({ repositoryId, pullRequestId, vote }) => {
+        const connection = await connectionProvider();
+        const gitApi = await connection.getGitApi();
+        const userDetails = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
+        const userId = userDetails.authenticatedUser.id;
+        if (!userId) {
+            throw new Error("Could not determine authenticated user ID.");
+        }
+        const voteMap = {
+            Approved: 10,
+            ApprovedWithSuggestions: 5,
+            NoVote: 0,
+            WaitingForAuthor: -5,
+            Rejected: -10,
+        };
+        await gitApi.createPullRequestReviewer({ vote: voteMap[vote], id: userId }, repositoryId, pullRequestId, userId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully cast vote '${vote}' on PR #${pullRequestId}.`,
+                },
+            ],
+        };
+    });
+    server.tool(REPO_TOOLS.list_directory, "List files and folders in a directory within a repository. Useful for exploring the structure of a codebase or finding related files.", {
+        repositoryId: z.string().describe("The ID or name of the repository."),
+        path: z.string().optional().default("/").describe("The directory path to list (e.g., '/src' or '/src/components'). Defaults to repository root."),
+        project: z.string().optional().describe("Project ID or name. Required if repositoryId is a name rather than a GUID."),
+        version: z.string().optional().describe("The version identifier - branch name (e.g., 'main'), tag name, or commit SHA. Defaults to the repository's default branch."),
+        versionType: z.enum(["Branch", "Commit", "Tag"]).optional().default("Branch").describe("The type of version identifier: 'Branch', 'Commit', or 'Tag'. Defaults to 'Branch'."),
+        recursive: z.boolean().optional().default(false).describe("Whether to list items recursively. Defaults to false."),
+        recursionDepth: z.number().optional().default(1).describe("Maximum depth for recursive listing (1-10). Only applies when recursive is true. Defaults to 1."),
+    }, async ({ repositoryId, path, project, version, versionType, recursive, recursionDepth }) => {
+        try {
+            const connection = await connectionProvider();
+            const gitApi = await connection.getGitApi();
+            const versionDescriptor = buildVersionDescriptor(version, versionType);
+            const clampedDepth = Math.min(Math.max(recursionDepth || 1, 1), 10);
+            let recursionType = VersionControlRecursionType.OneLevel;
+            if (recursive) {
+                recursionType = VersionControlRecursionType.Full;
+            }
+            const items = await gitApi.getItems(repositoryId, project, path, recursionType, true, false, false, false, versionDescriptor);
+            if (!items || items.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No items found at path: ${path}` }],
+                };
+            }
+            let filteredItems = items;
+            if (recursive && clampedDepth < 10) {
+                const basePath = path === "/" ? "" : path;
+                const baseDepth = basePath.split("/").filter((p) => p).length;
+                filteredItems = items.filter((item) => {
+                    if (!item.path)
+                        return false;
+                    const itemDepth = item.path.split("/").filter((p) => p).length;
+                    return itemDepth <= baseDepth + clampedDepth;
+                });
+            }
+            const formattedItems = filteredItems.map((item) => ({
+                path: item.path,
+                isFolder: item.isFolder,
+                gitObjectType: item.gitObjectType,
+                commitId: item.commitId,
+                contentMetadata: item.contentMetadata
+                    ? {
+                        contentType: item.contentMetadata.contentType,
+                        fileName: item.contentMetadata.fileName,
+                    }
+                    : undefined,
+            }));
+            const response = {
+                count: formattedItems.length,
+                path: path,
+                recursive: recursive,
+                recursionDepth: recursive ? clampedDepth : undefined,
+                items: formattedItems,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error listing directory: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
 }
 export { REPO_TOOLS, configureRepoTools };

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.4.0-nightly.20260222";
+export const packageVersion = "2.4.0-nightly.20260224";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.4.0-nightly.20260222",
+  "version": "2.4.0-nightly.20260224",
   "mcpName": "microsoft.com/azure-devops",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@azure/identity": "^4.10.0",
-    "@azure/msal-node": "^3.6.0",
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@azure/msal-node": "^5.0.4",
+    "@modelcontextprotocol/sdk": "1.27.0",
     "azure-devops-extension-api": "^4.264.0",
     "azure-devops-extension-sdk": "^4.0.2",
     "azure-devops-node-api": "^15.1.2",