@azure-devops/mcp 2.10.0-nightly.20260922 → 2.10.0-nightly.20260924

package/dist/shared/tool-annotations.js

@@ -32,6 +32,7 @@ const TOOL_ANNOTATIONS = {
     repo_branch: READ_ONLY_ANNOTATIONS,
     repo_create_branch: ADDITIVE_ANNOTATIONS,
     repo_file: READ_ONLY_ANNOTATIONS,
+    repo_file_write: MUTATING_ANNOTATIONS,
     repo_pull_request: READ_ONLY_ANNOTATIONS,
     repo_pull_request_org: READ_ONLY_ANNOTATIONS,
     repo_pull_request_thread: READ_ONLY_ANNOTATIONS,

package/dist/tools/repositories.js

@@ -1,6 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, GitPullRequestMergeStrategy, VersionControlRecursionType, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
+import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, GitPullRequestMergeStrategy, ItemContentType, VersionControlChangeType, VersionControlRecursionType, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
 import { z } from "zod";
 import { getCurrentUserDetails, getUserIdFromEmail } from "./auth.js";
 import { extractAdoStreamError, getEnumKeys, streamToString, apiVersion } from "../utils.js";
@@ -13,6 +13,7 @@ const REPO_TOOLS = {
     repo_pull_request_thread: "repo_pull_request_thread",
     repo_branch: "repo_branch",
     repo_file: "repo_file",
+    repo_file_write: "repo_file_write",
     repo_search_commits: "repo_search_commits",
     repo_pull_request_write: "repo_pull_request_write",
     repo_pull_request_thread_write: "repo_pull_request_thread_write",
@@ -199,9 +200,13 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         project: z.string().optional().describe("Project ID or project name. Required for list_by_commits. Optional for get and list."),
         includeWorkItemRefs: z.boolean().optional().default(false).describe("Whether to include work item references. Used for get."),
         includeLabels: z.boolean().optional().default(false).describe("Whether to include labels. Used for get."),
-        includeChangedFiles: z.boolean().optional().default(false).describe("Whether to include the list of changed files. Used for get."),
-        top: z.coerce.number().default(100).describe("The maximum number of pull requests to return. Used for list. Defaults to 100."),
-        skip: z.coerce.number().default(0).describe("The number of pull requests to skip. Used for list. Defaults to 0."),
+        includeChangedFiles: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether to include the list of changed files. When changedFilesSummary returns a nextSkip greater than 0, pass nextSkip and nextTop back as skip and top for the next page. Used for get."),
+        top: z.coerce.number().default(100).describe("The maximum number of pull requests to return (list), or of changed files to return (get with includeChangedFiles). Defaults to 100."),
+        skip: z.coerce.number().default(0).describe("The number of pull requests to skip (list), or of changed files to skip (get with includeChangedFiles). Defaults to 0."),
         created_by_me: z.boolean().default(false).describe("Filter pull requests created by the current user. Used for list."),
         created_by_user: z.string().optional().describe("Filter pull requests created by a specific user email. Used for list."),
         i_am_reviewer: z.boolean().default(false).describe("Filter pull requests where the current user is a reviewer. Used for list."),
@@ -249,7 +254,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
                         if (iterations?.length) {
                             const latestIteration = iterations[iterations.length - 1];
                             if (latestIteration.id != null) {
-                                const changes = await gitApi.getPullRequestIterationChanges(repositoryId, pullRequestId, latestIteration.id, project);
+                                const changes = await gitApi.getPullRequestIterationChanges(repositoryId, pullRequestId, latestIteration.id, project, top, skip);
                                 enhancedResponse = {
                                     ...enhancedResponse,
                                     changedFilesSummary: {
@@ -506,8 +511,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         versionType: z
             .enum(fileVersionTypeStrings)
             .optional()
-            .default("Commit")
-            .describe("How to interpret the version parameter. Used for get_content. Defaults to 'Commit'."),
+            .describe("How to interpret the version parameter. Defaults to 'Commit' for get_content and 'Branch' for list_directory."),
         recursive: z.boolean().optional().default(false).describe("Whether to list items recursively. Used for list_directory. Defaults to false."),
         recursionDepth: z.coerce.number().min(1).optional().default(1).describe("Maximum depth for recursive listing. Used for list_directory when recursive is true. Defaults to 1."),
     }, async ({ action, repositoryId, path, project, version, versionType, recursive, recursionDepth }) => {
@@ -517,7 +521,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             if (action === "get_content") {
                 if (!path)
                     return { content: [{ type: "text", text: "path is required for get_content" }], isError: true };
-                const versionDescriptor = version ? { version, versionType: GitVersionType[versionType] } : undefined;
+                const versionDescriptor = buildVersionDescriptor(version, versionType ?? "Commit");
                 const stream = await gitApi.getItemText(repositoryId, path, project, undefined, undefined, undefined, undefined, false, versionDescriptor, true);
                 const content = await streamToString(stream);
                 const streamError = extractAdoStreamError(content);
@@ -527,7 +531,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
                 return createExternalContentResponse(content, "repository file");
             }
             if (action === "list_directory") {
-                const versionDescriptor = buildVersionDescriptor(version, versionType === "Commit" ? "Branch" : versionType);
+                const versionDescriptor = buildVersionDescriptor(version, versionType);
                 const clampedDepth = Math.min(Math.max(recursionDepth || 1, 1), 10);
                 const recursionType = recursive ? VersionControlRecursionType.Full : VersionControlRecursionType.OneLevel;
                 const items = await gitApi.getItems(repositoryId, project, path, recursionType, true, false, false, false, versionDescriptor);
@@ -568,6 +572,63 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             return { content: [{ type: "text", text: `Error with file operation: ${errorMessage}` }], isError: true };
         }
     });
+    // --- repo_file_write -------------------------------------------------------
+    server.tool(REPO_TOOLS.repo_file_write, "Create or update a text file in an existing repository branch and commit the change.", {
+        action: z.enum(["create", "update"]).describe("Whether to create a new file or update an existing file."),
+        repositoryId: z.string().describe("The ID or name of the repository."),
+        project: z.string().optional().describe("Project ID or project name. Required when repositoryId is a name."),
+        branchName: z.string().min(1).describe("The name of the existing branch to update, without the 'refs/heads/' prefix."),
+        path: z.string().min(1).describe("The absolute repository path of the file, for example '/src/example.ts'."),
+        content: z.string().describe("The complete UTF-8 text content to write to the file."),
+        commitMessage: z.string().min(1).describe("The commit message for the file change."),
+        expectedOldObjectId: z
+            .string()
+            .optional()
+            .describe("The expected current commit ID of the branch. When provided, the push fails if the branch has moved. If omitted, the current branch head is retrieved before pushing."),
+    }, async ({ action, repositoryId, project, branchName, path, content, commitMessage, expectedOldObjectId }) => {
+        try {
+            const connection = await connectionProvider();
+            const gitApi = await connection.getGitApi();
+            const refName = `refs/heads/${branchName}`;
+            const refs = await gitApi.getRefs(repositoryId, project, "heads/", false, false, undefined, false, undefined, branchName);
+            const branch = refs.find((ref) => ref.name === refName);
+            if (!branch?.objectId) {
+                return { content: [{ type: "text", text: `Error: Branch '${branchName}' not found in repository ${repositoryId}` }], isError: true };
+            }
+            if (expectedOldObjectId && expectedOldObjectId !== branch.objectId) {
+                return { content: [{ type: "text", text: `Error: Branch '${branchName}' has moved from expected commit ${expectedOldObjectId}` }], isError: true };
+            }
+            const oldObjectId = branch.objectId;
+            const filePath = path.startsWith("/") ? path : `/${path}`;
+            const push = await gitApi.createPush({
+                refUpdates: [{ name: refName, oldObjectId }],
+                commits: [
+                    {
+                        comment: commitMessage,
+                        changes: [
+                            {
+                                changeType: action === "create" ? VersionControlChangeType.Add : VersionControlChangeType.Edit,
+                                item: { path: filePath },
+                                newContent: { content, contentType: ItemContentType.RawText },
+                            },
+                        ],
+                    },
+                ],
+            }, repositoryId, project);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ pushId: push.pushId, commitId: push.commits?.[0]?.commitId, branchName, path: filePath }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return { content: [{ type: "text", text: `Error writing repository file: ${errorMessage}` }], isError: true };
+        }
+    });
     // --- repo_search_commits ---------------------------------------------------
     server.tool(REPO_TOOLS.repo_search_commits, "Search commits with filtering by text, author, date range, and more.", {
         searchText: z.string().describe("Keywords to search for in commit messages"),

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.10.0-nightly.20260922";
+export const packageVersion = "2.10.0-nightly.20260924";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.10.0-nightly.20260922",
+  "version": "2.10.0-nightly.20260924",
   "mcpName": "microsoft.com/azure-devops",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",