@azure-devops/mcp 2.4.0 → 2.5.0-nightly.20260318

package/README.md

@@ -1,5 +1,10 @@
 # ⭐ Azure DevOps MCP Server
 
+> [!IMPORTANT]
+> The Azure DevOps Remote MCP Server is now available in public preview for all organizations. We recommend migrating to the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) going forward.
+>
+> [Learn more](#-remote-mcp-server)
+
 Easily install the Azure DevOps MCP Server for VS Code or VS Code Insiders:
 
 [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_AzureDevops_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
@@ -11,13 +16,14 @@ This TypeScript project provides a **local** MCP server for Azure DevOps, enabli
 
 1. [📺 Overview](#-overview)
 2. [🏆 Expectations](#-expectations)
-3. [⚙️ Supported Tools](#️-supported-tools)
-4. [🔌 Installation & Getting Started](#-installation--getting-started)
-5. [🌏 Using Domains](#-using-domains)
-6. [📝 Troubleshooting](#-troubleshooting)
-7. [🎩 Examples & Best Practices](#-examples--best-practices)
-8. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
-9. [📌 Contributing](#-contributing)
+3. [🚀 Remote MCP Server](#-remote-mcp-server)
+4. [⚙️ Supported Tools](#️-supported-tools)
+5. [🔌 Installation & Getting Started](#-installation--getting-started)
+6. [🌏 Using Domains](#-using-domains)
+7. [📝 Troubleshooting](#-troubleshooting)
+8. [🎩 Examples & Best Practices](#-examples--best-practices)
+9. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
+10. [📌 Contributing](#-contributing)
 
 ## 📺 Overview
 
@@ -40,13 +46,28 @@ The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prom
 
 The Azure DevOps MCP Server is built from tools that are concise, simple, focused, and easy to use—each designed for a specific scenario. We intentionally avoid complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs, making data access straightforward and letting the language model handle complex reasoning.
 
+## 🚀 Remote MCP Server
+
+The Azure DevOps **Remote MCP Server** is now available in [public preview](https://devblogs.microsoft.com/devops/azure-devops-remote-mcp-server-public-preview).
+
+Over time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.
+
+We encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.
+
+If you encounter issues with tools, need support, or have a feature request, you can report an issue using the [Remote MCP Server issue template](https://github.com/microsoft/azure-devops-mcp/issues/new?template=remote-mcp-server-issue.md). During the preview period, we will track Remote MCP Server issues through this repository.
+
+> [!WARNING]
+> Internal Microsoft users of the Remote MCP Server should **not** create issues in this repository. Please use the dedicated Teams channel instead.
+
+For instructions on how to get started with the Remote MCP Server, see the [onboarding documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server).
+
 ## ⚙️ Supported Tools
 
 See [TOOLSET.md](./docs/TOOLSET.md) for a comprehensive list.
 
 ## 🔌 Installation & Getting Started
 
-For the best experience, use Visual Studio Code and GitHub Copilot. See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.
+For the best experience, use Visual Studio Code and GitHub Copilot. See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, Cursor, Opencode, and Kilocode.
 
 ### Prerequisites
 

package/dist/shared/elicitations.js

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export async function elicitProject(server, connection, message) {
+    const coreApi = await connection.getCoreApi();
+    const projects = await coreApi.getProjects("wellFormed", 100, 0, undefined, false);
+    if (!projects || projects.length === 0) {
+        return { response: { content: [{ type: "text", text: "No projects found to select from." }], isError: true } };
+    }
+    const result = await server.server.elicitInput({
+        mode: "form",
+        message: message ?? "Select the Azure DevOps project.",
+        requestedSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: "string",
+                    title: "Project",
+                    description: "The Azure DevOps project.",
+                    oneOf: projects.map((p) => ({
+                        const: p.name ?? p.id ?? "",
+                        title: p.name ?? p.id ?? "Unknown project",
+                    })),
+                },
+            },
+            required: ["project"],
+        },
+    });
+    if (result.action !== "accept" || !result.content?.project) {
+        return { response: { content: [{ type: "text", text: "Project selection cancelled." }] } };
+    }
+    return { resolved: String(result.content.project) };
+}
+export async function elicitTeam(server, connection, project, message) {
+    const coreApi = await connection.getCoreApi();
+    const teams = await coreApi.getTeams(project, undefined, undefined, undefined, false);
+    if (!teams || teams.length === 0) {
+        return { response: { content: [{ type: "text", text: "No teams found to select from." }], isError: true } };
+    }
+    const result = await server.server.elicitInput({
+        mode: "form",
+        message: message ?? "Select the team.",
+        requestedSchema: {
+            type: "object",
+            properties: {
+                team: {
+                    type: "string",
+                    title: "Team",
+                    description: "The team from a specific Azure DevOps project.",
+                    oneOf: teams.map((t) => ({
+                        const: t.name ?? t.id ?? "",
+                        title: t.name ?? t.id ?? "Unknown team",
+                    })),
+                },
+            },
+            required: ["team"],
+        },
+    });
+    if (result.action !== "accept" || !result.content?.team) {
+        return { response: { content: [{ type: "text", text: "Team selection cancelled." }] } };
+    }
+    return { resolved: String(result.content.team) };
+}

package/dist/tools/core.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { searchIdentities } from "./auth.js";
+import { elicitProject } from "../shared/elicitations.js";
 const CORE_TOOLS = {
     list_project_teams: "core_list_project_teams",
     list_projects: "core_list_projects",
@@ -12,8 +13,8 @@ function filterProjectsByName(projects, projectNameFilter) {
     return projects.filter((project) => project.name?.toLowerCase().includes(lowerCaseFilter));
 }
 function configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    server.tool(CORE_TOOLS.list_project_teams, "Retrieve a list of teams for the specified Azure DevOps project.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(CORE_TOOLS.list_project_teams, "Retrieve a list of teams for an Azure DevOps project. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         mine: z.boolean().optional().describe("If true, only return teams that the authenticated user is a member of."),
         top: z.number().optional().describe("The maximum number of teams to return. Defaults to 100."),
         skip: z.number().optional().describe("The number of teams to skip for pagination. Defaults to 0."),
@@ -21,7 +22,14 @@ function configureCoreTools(server, tokenProvider, connectionProvider, userAgent
         try {
             const connection = await connectionProvider();
             const coreApi = await connection.getCoreApi();
-            const teams = await coreApi.getTeams(project, mine, top, skip, false);
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list teams for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
+            const teams = await coreApi.getTeams(resolvedProject, mine, top, skip, false);
             if (!teams) {
                 return { content: [{ type: "text", text: "No teams found" }], isError: true };
             }

package/dist/tools/pipelines.js

@@ -5,6 +5,8 @@ import { BuildQueryOrder, DefinitionQueryOrder } from "azure-devops-node-api/int
 import { z } from "zod";
 import { StageUpdateType } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
 import { ConfigurationType, RepositoryType } from "azure-devops-node-api/interfaces/PipelinesInterfaces.js";
+import { mkdirSync, createWriteStream } from "fs";
+import { join, resolve } from "path";
 const PIPELINE_TOOLS = {
     pipelines_get_builds: "pipelines_get_builds",
     pipelines_get_build_changes: "pipelines_get_build_changes",
@@ -18,6 +20,8 @@ const PIPELINE_TOOLS = {
     pipelines_get_run: "pipelines_get_run",
     pipelines_list_runs: "pipelines_list_runs",
     pipelines_run_pipeline: "pipelines_run_pipeline",
+    pipelines_list_artifacts: "pipelines_list_artifacts",
+    pipelines_download_artifact: "pipelines_download_artifact",
 };
 function configurePipelineTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(PIPELINE_TOOLS.pipelines_get_build_definitions, "Retrieves a list of build definitions for a given project.", {
@@ -315,5 +319,68 @@ function configurePipelineTools(server, tokenProvider, connectionProvider, userA
             content: [{ type: "text", text: JSON.stringify(updatedBuild, null, 2) }],
         };
     });
+    server.tool(PIPELINE_TOOLS.pipelines_list_artifacts, "Lists artifacts for a given build.", {
+        project: z.string().describe("The name or ID of the project."),
+        buildId: z.number().describe("The ID of the build."),
+    }, async ({ project, buildId }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const artifacts = await buildApi.getArtifacts(project, buildId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(artifacts, null, 2) }],
+        };
+    });
+    server.tool(PIPELINE_TOOLS.pipelines_download_artifact, "Downloads a pipeline artifact.", {
+        project: z.string().describe("The name or ID of the project."),
+        buildId: z.number().describe("The ID of the build."),
+        artifactName: z.string().describe("The name of the artifact to download."),
+        destinationPath: z.string().optional().describe("The local path to download the artifact to. If not provided, returns binary content as base64."),
+    }, async ({ project, buildId, artifactName, destinationPath }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const artifact = await buildApi.getArtifact(project, buildId, artifactName);
+        if (!artifact) {
+            return {
+                content: [{ type: "text", text: `Artifact ${artifactName} not found in build ${buildId}.` }],
+            };
+        }
+        const fileStream = await buildApi.getArtifactContentZip(project, buildId, artifactName);
+        // If destinationPath is provided, save to disk
+        if (destinationPath) {
+            const fullDestinationPath = resolve(destinationPath);
+            mkdirSync(fullDestinationPath, { recursive: true });
+            const fileDestinationPath = join(fullDestinationPath, `${artifactName}.zip`);
+            const writeStream = createWriteStream(fileDestinationPath);
+            await new Promise((resolve, reject) => {
+                fileStream.pipe(writeStream);
+                fileStream.on("end", () => resolve());
+                fileStream.on("error", (err) => reject(err));
+            });
+            return {
+                content: [{ type: "text", text: `Artifact ${artifactName} downloaded to ${destinationPath}.` }],
+            };
+        }
+        // Otherwise, return binary content as base64
+        const chunks = [];
+        await new Promise((resolve, reject) => {
+            fileStream.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+            fileStream.on("end", () => resolve());
+            fileStream.on("error", (err) => reject(err));
+        });
+        const buffer = Buffer.concat(chunks);
+        const base64Data = buffer.toString("base64");
+        return {
+            content: [
+                {
+                    type: "resource",
+                    resource: {
+                        uri: `data:application/zip;base64,${base64Data}`,
+                        mimeType: "application/zip",
+                        text: base64Data,
+                    },
+                },
+            ],
+        };
+    });
 }
 export { PIPELINE_TOOLS, configurePipelineTools };