@azure-devops/mcp 1.3.1-nightly.20250824 → 2.0.0-nightly.20250825

package/README.md

@@ -42,16 +42,6 @@ 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.
 
-## ✨ Recent Enhancements
-
-### 📖 **Enhanced Wiki Support**
-
-- **Full Content Management**: Create and update wiki pages with complete content using the native Azure DevOps REST API
-- **Automatic ETag Handling**: Safe updates with built-in conflict resolution for concurrent edits
-- **Immediate Visibility**: Pages appear instantly in the Azure DevOps wiki interface
-- **Hierarchical Structure**: Support for organized page structures within existing folder hierarchies
-- **Robust Error Handling**: Comprehensive error management for various HTTP status codes and edge cases
-
 ## ⚙️ Supported Tools
 
 Interact with these Azure DevOps services:
@@ -120,7 +110,6 @@ Interact with these Azure DevOps services:
 - **build_get_log**: Retrieve the logs for a specific build.
 - **build_get_log_by_id**: Get a specific build log by log ID.
 - **build_get_changes**: Get the changes associated with a specific build.
-- **build_get_timeline**: Retrieve the timeline for a specific build, showing detailed information about steps and tasks.
 - **build_run_build**: Trigger a new build for a specified definition.
 - **build_get_status**: Fetch the status of a specific build.
 - **build_update_build_stage**: Update the stage of a specific build.

package/dist/index.js

@@ -11,16 +11,25 @@ import { configurePrompts } from "./prompts.js";
 import { configureAllTools } from "./tools.js";
 import { UserAgentComposer } from "./useragent.js";
 import { packageVersion } from "./version.js";
+import { DomainsManager } from "./shared/domains.js";
 // Parse command line arguments using yargs
 const argv = yargs(hideBin(process.argv))
     .scriptName("mcp-server-azuredevops")
     .usage("Usage: $0 <organization> [options]")
     .version(packageVersion)
-    .command("$0 <organization>", "Azure DevOps MCP Server", (yargs) => {
+    .command("$0 <organization> [options]", "Azure DevOps MCP Server", (yargs) => {
     yargs.positional("organization", {
         describe: "Azure DevOps organization name",
         type: "string",
+        demandOption: true,
     });
+})
+    .option("domains", {
+    alias: "d",
+    describe: "Domain(s) to enable: 'all' for everything, or specific domains like 'repositories builds work'. Defaults to 'all'.",
+    type: "string",
+    array: true,
+    default: "all",
 })
     .option("tenant", {
     alias: "t",
@@ -29,9 +38,11 @@ const argv = yargs(hideBin(process.argv))
 })
     .help()
     .parseSync();
-export const orgName = argv.organization;
 const tenantId = argv.tenant;
+export const orgName = argv.organization;
 const orgUrl = "https://dev.azure.com/" + orgName;
+const domainsManager = new DomainsManager(argv.domains);
+export const enabledDomains = domainsManager.getEnabledDomains();
 async function getAzureDevOpsToken() {
     if (process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS) {
         process.env.AZURE_TOKEN_CREDENTIALS = process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS;
@@ -73,7 +84,7 @@ async function main() {
         userAgentComposer.appendMcpClientInfo(server.server.getClientVersion());
     };
     configurePrompts(server);
-    configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient(userAgentComposer), () => userAgentComposer.userAgent);
+    configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient(userAgentComposer), () => userAgentComposer.userAgent, enabledDomains);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/prompts.js

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { CORE_TOOLS } from "./tools/core.js";
-import { WORKITEM_TOOLS } from "./tools/workitems.js";
+import { WORKITEM_TOOLS } from "./tools/work-items.js";
 function configurePrompts(server) {
     server.prompt("Projects", "Lists all projects in the Azure DevOps organization.", {}, () => ({
         messages: [

package/dist/shared/domains.js

@@ -0,0 +1,122 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Available Azure DevOps MCP domains
+ */
+export var Domain;
+(function (Domain) {
+    Domain["ADVANCED_SECURITY"] = "advanced-security";
+    Domain["BUILDS"] = "builds";
+    Domain["CORE"] = "core";
+    Domain["RELEASES"] = "releases";
+    Domain["REPOSITORIES"] = "repositories";
+    Domain["SEARCH"] = "search";
+    Domain["TEST_PLANS"] = "test-plans";
+    Domain["WIKI"] = "wiki";
+    Domain["WORK"] = "work";
+    Domain["WORK_ITEMS"] = "work-items";
+})(Domain || (Domain = {}));
+export const ALL_DOMAINS = "all";
+/**
+ * Manages domain parsing and validation for Azure DevOps MCP server tools
+ */
+export class DomainsManager {
+    static AVAILABLE_DOMAINS = Object.values(Domain);
+    enabledDomains;
+    constructor(domainsInput) {
+        this.enabledDomains = new Set();
+        const normalizedInput = DomainsManager.parseDomainsInput(domainsInput);
+        this.parseDomains(normalizedInput);
+    }
+    /**
+     * Parse and validate domains from input
+     * @param domainsInput - Either "all", single domain name, array of domain names, or undefined (defaults to "all")
+     */
+    parseDomains(domainsInput) {
+        if (!domainsInput) {
+            this.enableAllDomains();
+            return;
+        }
+        if (Array.isArray(domainsInput)) {
+            this.handleArrayInput(domainsInput);
+            return;
+        }
+        this.handleStringInput(domainsInput);
+    }
+    handleArrayInput(domainsInput) {
+        if (domainsInput.length === 0 || domainsInput.includes(ALL_DOMAINS)) {
+            this.enableAllDomains();
+            return;
+        }
+        if (domainsInput.length === 1 && domainsInput[0] === ALL_DOMAINS) {
+            this.enableAllDomains();
+            return;
+        }
+        const domains = domainsInput.map((d) => d.trim().toLowerCase());
+        this.validateAndAddDomains(domains);
+    }
+    handleStringInput(domainsInput) {
+        if (domainsInput === ALL_DOMAINS) {
+            this.enableAllDomains();
+            return;
+        }
+        const domains = [domainsInput.trim().toLowerCase()];
+        this.validateAndAddDomains(domains);
+    }
+    validateAndAddDomains(domains) {
+        const availableDomainsAsStringArray = Object.values(Domain);
+        domains.forEach((domain) => {
+            if (availableDomainsAsStringArray.includes(domain)) {
+                this.enabledDomains.add(domain);
+            }
+            else if (domain === ALL_DOMAINS) {
+                this.enableAllDomains();
+            }
+            else {
+                console.error(`Error: Specified invalid domain '${domain}'. Please specify exactly as available domains: ${Object.values(Domain).join(", ")}`);
+            }
+        });
+        if (this.enabledDomains.size === 0) {
+            this.enableAllDomains();
+        }
+    }
+    enableAllDomains() {
+        Object.values(Domain).forEach((domain) => this.enabledDomains.add(domain));
+    }
+    /**
+     * Check if a specific domain is enabled
+     * @param domain - Domain name to check
+     * @returns true if domain is enabled
+     */
+    isDomainEnabled(domain) {
+        return this.enabledDomains.has(domain);
+    }
+    /**
+     * Get all enabled domains
+     * @returns Set of enabled domain names
+     */
+    getEnabledDomains() {
+        return new Set(this.enabledDomains);
+    }
+    /**
+     * Get list of all available domains
+     * @returns Array of available domain names
+     */
+    static getAvailableDomains() {
+        return Object.values(Domain);
+    }
+    /**
+     * Parse domains input from string or array to a normalized array of strings
+     * @param domainsInput - Domains input to parse
+     * @returns Normalized array of domain strings
+     */
+    static parseDomainsInput(domainsInput) {
+        if (!domainsInput) {
+            return [];
+        }
+        if (typeof domainsInput === "string") {
+            return domainsInput.split(",").map((d) => d.trim().toLowerCase());
+        }
+        return domainsInput.map((d) => d.trim().toLowerCase());
+    }
+}

package/dist/tools/builds.js

@@ -14,7 +14,6 @@ const BUILD_TOOLS = {
     run_build: "build_run_build",
     get_status: "build_get_status",
     update_build_stage: "build_update_build_stage",
-    get_timeline: "build_get_timeline",
 };
 function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(BUILD_TOOLS.get_definitions, "Retrieves a list of build definitions for a given project.", {
@@ -205,19 +204,5 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(updatedBuild, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_timeline, "Retrieves the timeline for a specific build, showing detailed information about steps and tasks.", {
-        project: z.string().describe("Project ID or name to get the build timeline for"),
-        buildId: z.number().describe("ID of the build to get the timeline for"),
-        timelineId: z.string().optional().describe("The ID of a specific timeline to retrieve. If not specified, the primary timeline is returned."),
-        changeId: z.number().optional().describe("If specified, only includes timeline records that changed after this watermark."),
-        planId: z.string().optional().describe("The ID of the plan to retrieve the timeline for."),
-    }, async ({ project, buildId, timelineId, changeId, planId }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const timeline = await buildApi.getBuildTimeline(project, buildId, timelineId, changeId, planId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(timeline, null, 2) }],
-        };
-    });
 }
 export { BUILD_TOOLS, configureBuildTools };

package/dist/tools.js

@@ -1,25 +1,31 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { configureAdvSecTools } from "./tools/advsec.js";
+import { Domain } from "./shared/domains.js";
+import { configureAdvSecTools } from "./tools/advanced-security.js";
 import { configureBuildTools } from "./tools/builds.js";
 import { configureCoreTools } from "./tools/core.js";
 import { configureReleaseTools } from "./tools/releases.js";
-import { configureRepoTools } from "./tools/repos.js";
+import { configureRepoTools } from "./tools/repositories.js";
 import { configureSearchTools } from "./tools/search.js";
-import { configureTestPlanTools } from "./tools/testplans.js";
+import { configureTestPlanTools } from "./tools/test-plans.js";
 import { configureWikiTools } from "./tools/wiki.js";
 import { configureWorkTools } from "./tools/work.js";
-import { configureWorkItemTools } from "./tools/workitems.js";
-function configureAllTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider);
-    configureWorkTools(server, tokenProvider, connectionProvider);
-    configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider);
-    configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider);
-    configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider);
-    configureReleaseTools(server, tokenProvider, connectionProvider);
-    configureWikiTools(server, tokenProvider, connectionProvider);
-    configureTestPlanTools(server, tokenProvider, connectionProvider);
-    configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider);
-    configureAdvSecTools(server, tokenProvider, connectionProvider);
+import { configureWorkItemTools } from "./tools/work-items.js";
+function configureAllTools(server, tokenProvider, connectionProvider, userAgentProvider, enabledDomains) {
+    const configureIfDomainEnabled = (domain, configureFn) => {
+        if (enabledDomains.has(domain)) {
+            configureFn();
+        }
+    };
+    configureIfDomainEnabled(Domain.CORE, () => configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.WORK, () => configureWorkTools(server, tokenProvider, connectionProvider));
+    configureIfDomainEnabled(Domain.BUILDS, () => configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.REPOSITORIES, () => configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.WORK_ITEMS, () => configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.RELEASES, () => configureReleaseTools(server, tokenProvider, connectionProvider));
+    configureIfDomainEnabled(Domain.WIKI, () => configureWikiTools(server, tokenProvider, connectionProvider));
+    configureIfDomainEnabled(Domain.TEST_PLANS, () => configureTestPlanTools(server, tokenProvider, connectionProvider));
+    configureIfDomainEnabled(Domain.SEARCH, () => configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.ADVANCED_SECURITY, () => configureAdvSecTools(server, tokenProvider, connectionProvider));
 }
 export { configureAllTools };

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "1.3.1-nightly.20250824";
+export const packageVersion = "2.0.0-nightly.20250825";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "1.3.1-nightly.20250824",
+  "version": "2.0.0-nightly.20250825",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",