@azure-devops/mcp 0.1.0 → 0.2.0-preview-oauth

package/dist/tools.js

@@ -1,21 +1,31 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { configureCoreTools } from "./tools/core.js";
+import { Domain } from "./shared/domains.js";
+import { configureAdvSecTools } from "./tools/advanced-security.js";
 import { configureBuildTools } from "./tools/builds.js";
-import { configureRepoTools } from "./tools/repos.js";
-import { configureWorkItemTools } from "./tools/workitems.js";
+import { configureCoreTools } from "./tools/core.js";
 import { configureReleaseTools } from "./tools/releases.js";
-import { configureWikiTools } from "./tools/wiki.js";
-import { configureTestPlanTools } from "./tools/testplans.js";
+import { configureRepoTools } from "./tools/repositories.js";
 import { configureSearchTools } from "./tools/search.js";
-function configureAllTools(server, tokenProvider, connectionProvider) {
-    configureCoreTools(server, tokenProvider, connectionProvider);
-    configureBuildTools(server, tokenProvider, connectionProvider);
-    configureRepoTools(server, tokenProvider, connectionProvider);
-    configureWorkItemTools(server, tokenProvider, connectionProvider);
-    configureReleaseTools(server, tokenProvider, connectionProvider);
-    configureWikiTools(server, tokenProvider, connectionProvider);
-    configureTestPlanTools(server, tokenProvider, connectionProvider);
-    configureSearchTools(server, tokenProvider, connectionProvider);
+import { configureTestPlanTools } from "./tools/test-plans.js";
+import { configureWikiTools } from "./tools/wiki.js";
+import { configureWorkTools } from "./tools/work.js";
+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, userAgentProvider));
+    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/useragent.js

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+class UserAgentComposer {
+    _userAgent;
+    _mcpClientInfoAppended;
+    constructor(packageVersion) {
+        this._userAgent = `AzureDevOps.MCP/${packageVersion} (local)`;
+        this._mcpClientInfoAppended = false;
+    }
+    get userAgent() {
+        return this._userAgent;
+    }
+    appendMcpClientInfo(info) {
+        if (!this._mcpClientInfoAppended && info && info.name && info.version) {
+            this._userAgent += ` ${info.name}/${info.version}`;
+            this._mcpClientInfoAppended = true;
+        }
+    }
+}
+export { UserAgentComposer };

package/dist/utils.js

@@ -1,6 +1,56 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { packageVersion } from "./version.js";
 export const apiVersion = "7.2-preview.1";
 export const batchApiVersion = "5.0";
-export const userAgent = `AzureDevOps.MCP/${packageVersion} (local)`;
+export const markdownCommentsApiVersion = "7.2-preview.4";
+export function createEnumMapping(enumObject) {
+    const mapping = {};
+    for (const [key, value] of Object.entries(enumObject)) {
+        if (typeof key === "string" && typeof value === "number") {
+            mapping[key.toLowerCase()] = value;
+        }
+    }
+    return mapping;
+}
+export function mapStringToEnum(value, enumObject, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const enumMapping = createEnumMapping(enumObject);
+    return enumMapping[value.toLowerCase()] ?? defaultValue;
+}
+/**
+ * Maps an array of strings to an array of enum values, filtering out invalid values.
+ * @param values Array of string values to map
+ * @param enumObject The enum object to map to
+ * @returns Array of valid enum values
+ */
+export function mapStringArrayToEnum(values, enumObject) {
+    if (!values)
+        return [];
+    return values.map((value) => mapStringToEnum(value, enumObject)).filter((v) => v !== undefined);
+}
+/**
+ * Converts a TypeScript numeric enum to an array of string keys for use with z.enum().
+ * This ensures that enum schemas generate string values rather than numeric values.
+ * @param enumObject The TypeScript enum object
+ * @returns Array of string keys from the enum
+ */
+export function getEnumKeys(enumObject) {
+    return Object.keys(enumObject).filter((key) => isNaN(Number(key)));
+}
+/**
+ * Safely converts a string enum key to its corresponding enum value.
+ * Validates that the key exists in the enum before conversion.
+ * @param enumObject The TypeScript enum object
+ * @param key The string key to convert
+ * @returns The enum value if key is valid, undefined otherwise
+ */
+export function safeEnumConvert(enumObject, key) {
+    if (!key)
+        return undefined;
+    const validKeys = getEnumKeys(enumObject);
+    if (!validKeys.includes(key)) {
+        return undefined;
+    }
+    return enumObject[key];
+}

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "0.1.0";
+export const packageVersion = "0.2.0-preview-oauth";

package/package.json

@@ -1,55 +1,65 @@
-{
-  "name": "@azure-devops/mcp",
-  "version": "0.1.0",
-  "description": "MCP server for interacting with Azure DevOps",
-  "license": "MIT",
-  "author": "Microsoft Corporation",
-  "homepage": "TBD",
-  "bugs": "TBD",
-  "type": "module",
-  "bin": {
-    "mcp-server-azuredevops": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "preinstall": "npm config set registry https://registry.npmjs.org/",
-    "prebuild": "node -p \"'export const packageVersion = ' + JSON.stringify(require('./package.json').version) + ';\\r'\" > src/version.ts",
-    "build": "tsc && shx chmod +x dist/*.js",
-    "prepare": "npm run build",
-    "watch": "tsc --watch",
-    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
-    "start": "node -r tsconfig-paths/register dist/index.js",
-    "eslint": "eslint",
-    "eslint-fix": "eslint --fix",
-    "clean": "shx rm -rf dist",
-    "test": "jest"
-  },
-  "dependencies": {
-    "@azure/identity": "^4.10.0",
-    "@modelcontextprotocol/sdk": "1.12.1",
-    "azure-devops-extension-api": "^4.252.0",
-    "azure-devops-extension-sdk": "^4.0.2",
-    "azure-devops-node-api": "^15.1.0",
-    "save-dev": "^0.0.1-security",
-    "zod": "^3.25.55",
-    "zod-to-json-schema": "^3.24.5"
-  },
-  "devDependencies": {
-    "@modelcontextprotocol/inspector": "^0.14.0",
-    "@types/node": "^22",
-    "@types/jest": "^29.5.14",
-    "eslint-plugin-header": "^3.1.1",
-    "jest": "^29.7.0",
-    "jest-extended": "^6.0.0",
-    "shx": "^0.4.0",
-    "ts-jest": "^29.3.4",
-    "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1"
-  }
-}
+{
+  "name": "@azure-devops/mcp",
+  "version": "0.2.0-preview-oauth",
+  "description": "MCP server for interacting with Azure DevOps",
+  "license": "MIT",
+  "author": "Microsoft Corporation",
+  "homepage": "https://github.com/microsoft/azure-devops-mcp",
+  "bugs": "https://github.com/microsoft/azure-devops-mcp/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/azure-devops-mcp.git"
+  },
+  "type": "module",
+  "bin": {
+    "mcp-server-azuredevops": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "preinstall": "npm config set registry https://registry.npmjs.org/",
+    "prebuild": "node -p \"'export const packageVersion = ' + JSON.stringify(require('./package.json').version) + ';\\n'\" > src/version.ts && prettier --write src/version.ts",
+    "validate-tools": "tsc --noEmit && node scripts/build-validate-tools.js",
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "inspect": "ALLOWED_ORIGINS=http://127.0.0.1:6274 npx @modelcontextprotocol/inspector node dist/index.js",
+    "start": "node -r tsconfig-paths/register dist/index.js",
+    "eslint": "eslint",
+    "eslint-fix": "eslint --fix",
+    "format": "prettier --write .",
+    "format-check": "prettier --check .",
+    "clean": "shx rm -rf dist",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@azure/identity": "^4.10.0",
+    "@modelcontextprotocol/sdk": "1.17.0",
+    "azure-devops-extension-api": "^4.252.0",
+    "azure-devops-extension-sdk": "^4.0.2",
+    "azure-devops-node-api": "^15.1.0",
+    "yargs": "^18.0.0",
+    "zod": "^3.25.63",
+    "zod-to-json-schema": "^3.24.5"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.16.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-header": "^3.1.1",
+    "glob": "^11.0.3",
+    "jest": "^30.0.2",
+    "jest-extended": "^6.0.0",
+    "prettier": "3.6.2",
+    "shx": "^0.4.0",
+    "ts-jest": "^29.4.0",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.32.1"
+  }
+}