@azure-devops/mcp 2.4.0 → 2.5.0-nightly.20260318
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -8
- package/dist/auth.js +0 -0
- package/dist/index.js +0 -0
- package/dist/logger.js +0 -0
- package/dist/org-tenants.js +0 -0
- package/dist/prompts.js +0 -0
- package/dist/shared/elicitations.js +62 -0
- package/dist/tools/core.js +11 -3
- package/dist/tools/pipelines.js +67 -0
- package/dist/tools/repositories.js +200 -44
- package/dist/tools/test-plans.js +77 -27
- package/dist/tools/work-items.js +39 -0
- package/dist/tools/work.js +108 -15
- package/dist/tools.js +0 -0
- package/dist/useragent.js +0 -0
- package/dist/utils.js +0 -0
- package/dist/version.js +1 -1
- package/package.json +6 -7
- package/dist/tools/builds.js +0 -271
- package/dist/tools/releases.js +0 -97
package/dist/tools/work-items.js
CHANGED
|
@@ -16,6 +16,7 @@ const WORKITEM_TOOLS = {
|
|
|
16
16
|
list_work_item_revisions: "wit_list_work_item_revisions",
|
|
17
17
|
get_work_items_for_iteration: "wit_get_work_items_for_iteration",
|
|
18
18
|
add_work_item_comment: "wit_add_work_item_comment",
|
|
19
|
+
update_work_item_comment: "wit_update_work_item_comment",
|
|
19
20
|
add_child_work_items: "wit_add_child_work_items",
|
|
20
21
|
link_work_item_to_pull_request: "wit_link_work_item_to_pull_request",
|
|
21
22
|
get_work_item_type: "wit_get_work_item_type",
|
|
@@ -259,6 +260,44 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
|
|
|
259
260
|
};
|
|
260
261
|
}
|
|
261
262
|
});
|
|
263
|
+
server.tool(WORKITEM_TOOLS.update_work_item_comment, "Update an existing comment on a work item by ID.", {
|
|
264
|
+
project: z.string().describe("The name or ID of the Azure DevOps project."),
|
|
265
|
+
workItemId: z.number().describe("The ID of the work item."),
|
|
266
|
+
commentId: z.number().describe("The ID of the comment to update."),
|
|
267
|
+
text: z.string().describe("The updated comment text."),
|
|
268
|
+
format: z.enum(["markdown", "html"]).optional().default("html"),
|
|
269
|
+
}, async ({ project, workItemId, commentId, text, format }) => {
|
|
270
|
+
try {
|
|
271
|
+
const connection = await connectionProvider();
|
|
272
|
+
const orgUrl = connection.serverUrl;
|
|
273
|
+
const accessToken = await tokenProvider();
|
|
274
|
+
const body = { text };
|
|
275
|
+
const formatParameter = format === "markdown" ? 0 : 1;
|
|
276
|
+
const response = await fetch(`${orgUrl}/${project}/_apis/wit/workItems/${workItemId}/comments/${commentId}?format=${formatParameter}&api-version=${markdownCommentsApiVersion}`, {
|
|
277
|
+
method: "PATCH",
|
|
278
|
+
headers: {
|
|
279
|
+
"Authorization": `Bearer ${accessToken}`,
|
|
280
|
+
"Content-Type": "application/json",
|
|
281
|
+
"User-Agent": userAgentProvider(),
|
|
282
|
+
},
|
|
283
|
+
body: JSON.stringify(body),
|
|
284
|
+
});
|
|
285
|
+
if (!response.ok) {
|
|
286
|
+
throw new Error(`Failed to update work item comment: ${response.statusText}`);
|
|
287
|
+
}
|
|
288
|
+
const updatedComment = await response.text();
|
|
289
|
+
return {
|
|
290
|
+
content: [{ type: "text", text: updatedComment }],
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
catch (error) {
|
|
294
|
+
const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
|
|
295
|
+
return {
|
|
296
|
+
content: [{ type: "text", text: `Error updating work item comment: ${errorMessage}` }],
|
|
297
|
+
isError: true,
|
|
298
|
+
};
|
|
299
|
+
}
|
|
300
|
+
});
|
|
262
301
|
server.tool(WORKITEM_TOOLS.list_work_item_revisions, "Retrieve list of revisions for a work item by ID.", {
|
|
263
302
|
project: z.string().describe("The name or ID of the Azure DevOps project."),
|
|
264
303
|
workItemId: z.number().describe("The ID of the work item to retrieve revisions for."),
|
package/dist/tools/work.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
// Licensed under the MIT License.
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
import { TreeStructureGroup, TreeNodeStructureType } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
|
|
5
|
+
import { elicitProject, elicitTeam } from "../shared/elicitations.js";
|
|
5
6
|
const WORK_TOOLS = {
|
|
6
7
|
list_team_iterations: "work_list_team_iterations",
|
|
7
8
|
list_iterations: "work_list_iterations",
|
|
@@ -10,22 +11,40 @@ const WORK_TOOLS = {
|
|
|
10
11
|
get_team_capacity: "work_get_team_capacity",
|
|
11
12
|
update_team_capacity: "work_update_team_capacity",
|
|
12
13
|
get_iteration_capacities: "work_get_iteration_capacities",
|
|
14
|
+
get_team_settings: "work_get_team_settings",
|
|
13
15
|
};
|
|
14
16
|
function configureWorkTools(server, _, connectionProvider) {
|
|
15
|
-
server.tool(WORK_TOOLS.list_team_iterations, "Retrieve a list of iterations for a specific team in a project.", {
|
|
16
|
-
project: z.string().describe("The name or ID of the Azure DevOps project."),
|
|
17
|
-
team: z.string().describe("The name or ID of the Azure DevOps team."),
|
|
17
|
+
server.tool(WORK_TOOLS.list_team_iterations, "Retrieve a list of iterations for a specific team in a project. If a project or team is not specified, you will be prompted to select one.", {
|
|
18
|
+
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."),
|
|
19
|
+
team: z.string().optional().describe("The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown."),
|
|
18
20
|
timeframe: z.enum(["current"]).optional().describe("The timeframe for which to retrieve iterations. Currently, only 'current' is supported."),
|
|
19
21
|
}, async ({ project, team, timeframe }) => {
|
|
20
22
|
try {
|
|
21
23
|
const connection = await connectionProvider();
|
|
24
|
+
let resolvedProject = project;
|
|
25
|
+
if (!resolvedProject) {
|
|
26
|
+
const result = await elicitProject(server, connection, "Select the Azure DevOps project to list team iterations for.");
|
|
27
|
+
if ("response" in result)
|
|
28
|
+
return result.response;
|
|
29
|
+
resolvedProject = result.resolved;
|
|
30
|
+
}
|
|
31
|
+
let resolvedTeam = team;
|
|
32
|
+
if (!resolvedTeam) {
|
|
33
|
+
const result = await elicitTeam(server, connection, resolvedProject, "Select the Azure DevOps team to list iterations for.");
|
|
34
|
+
if ("response" in result)
|
|
35
|
+
return result.response;
|
|
36
|
+
resolvedTeam = result.resolved;
|
|
37
|
+
}
|
|
22
38
|
const workApi = await connection.getWorkApi();
|
|
23
|
-
const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
|
|
39
|
+
const iterations = await workApi.getTeamIterations({ project: resolvedProject, team: resolvedTeam }, timeframe);
|
|
24
40
|
if (!iterations) {
|
|
25
41
|
return { content: [{ type: "text", text: "No iterations found" }], isError: true };
|
|
26
42
|
}
|
|
27
43
|
return {
|
|
28
|
-
content: [
|
|
44
|
+
content: [
|
|
45
|
+
{ type: "text", text: `Project: ${resolvedProject}, Team: ${resolvedTeam}` },
|
|
46
|
+
{ type: "text", text: JSON.stringify(iterations, null, 2) },
|
|
47
|
+
],
|
|
29
48
|
};
|
|
30
49
|
}
|
|
31
50
|
catch (error) {
|
|
@@ -78,19 +97,26 @@ function configureWorkTools(server, _, connectionProvider) {
|
|
|
78
97
|
};
|
|
79
98
|
}
|
|
80
99
|
});
|
|
81
|
-
server.tool(WORK_TOOLS.list_iterations, "List all iterations in a specified Azure DevOps project.", {
|
|
82
|
-
project: z.string().describe("The name or ID of the Azure DevOps project."),
|
|
100
|
+
server.tool(WORK_TOOLS.list_iterations, "List all iterations in a specified Azure DevOps project. If a project is not specified, you will be prompted to select one.", {
|
|
101
|
+
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."),
|
|
83
102
|
depth: z.number().default(2).describe("Depth of children to fetch."),
|
|
84
103
|
excludedIds: z.array(z.number()).optional().describe("An optional array of iteration IDs, and thier children, that should not be returned."),
|
|
85
104
|
}, async ({ project, depth, excludedIds: ids }) => {
|
|
86
105
|
try {
|
|
87
106
|
const connection = await connectionProvider();
|
|
107
|
+
let resolvedProject = project;
|
|
108
|
+
if (!resolvedProject) {
|
|
109
|
+
const result = await elicitProject(server, connection, "Select the Azure DevOps project to list iterations for.");
|
|
110
|
+
if ("response" in result)
|
|
111
|
+
return result.response;
|
|
112
|
+
resolvedProject = result.resolved;
|
|
113
|
+
}
|
|
88
114
|
const workItemTrackingApi = await connection.getWorkItemTrackingApi();
|
|
89
115
|
let results = [];
|
|
90
116
|
if (depth === undefined) {
|
|
91
117
|
depth = 1;
|
|
92
118
|
}
|
|
93
|
-
results = await workItemTrackingApi.getClassificationNodes(
|
|
119
|
+
results = await workItemTrackingApi.getClassificationNodes(resolvedProject, [], depth);
|
|
94
120
|
// Handle null or undefined results
|
|
95
121
|
if (!results) {
|
|
96
122
|
return { content: [{ type: "text", text: "No iterations were found" }], isError: true };
|
|
@@ -165,15 +191,22 @@ function configureWorkTools(server, _, connectionProvider) {
|
|
|
165
191
|
};
|
|
166
192
|
}
|
|
167
193
|
});
|
|
168
|
-
server.tool(WORK_TOOLS.get_team_capacity, "Get the team capacity of a specific team and iteration in a project.", {
|
|
169
|
-
project: z.string().describe("The name or Id of the Azure DevOps project."),
|
|
170
|
-
team: z.string().describe("The name or Id of the Azure DevOps team."),
|
|
194
|
+
server.tool(WORK_TOOLS.get_team_capacity, "Get the team capacity of a specific team and iteration in a project. If a project is not specified, you will be prompted to select one.", {
|
|
195
|
+
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."),
|
|
196
|
+
team: z.string().describe("The name or Id of the Azure DevOps team. Reuse from prior context if already known."),
|
|
171
197
|
iterationId: z.string().describe("The Iteration Id to get capacity for."),
|
|
172
198
|
}, async ({ project, team, iterationId }) => {
|
|
173
199
|
try {
|
|
174
200
|
const connection = await connectionProvider();
|
|
201
|
+
let resolvedProject = project;
|
|
202
|
+
if (!resolvedProject) {
|
|
203
|
+
const result = await elicitProject(server, connection, "Select the Azure DevOps project to get team capacity for.");
|
|
204
|
+
if ("response" in result)
|
|
205
|
+
return result.response;
|
|
206
|
+
resolvedProject = result.resolved;
|
|
207
|
+
}
|
|
175
208
|
const workApi = await connection.getWorkApi();
|
|
176
|
-
const teamContext = { project, team };
|
|
209
|
+
const teamContext = { project: resolvedProject, team };
|
|
177
210
|
const rawResults = await workApi.getCapacitiesWithIdentityRefAndTotals(teamContext, iterationId);
|
|
178
211
|
if (!rawResults || rawResults.teamMembers?.length === 0) {
|
|
179
212
|
return { content: [{ type: "text", text: "No team capacity assigned to the team" }], isError: true };
|
|
@@ -271,14 +304,21 @@ function configureWorkTools(server, _, connectionProvider) {
|
|
|
271
304
|
};
|
|
272
305
|
}
|
|
273
306
|
});
|
|
274
|
-
server.tool(WORK_TOOLS.get_iteration_capacities, "Get an iteration's capacity for all teams in iteration and project.", {
|
|
275
|
-
project: z.string().describe("The name or Id of the Azure DevOps project."),
|
|
307
|
+
server.tool(WORK_TOOLS.get_iteration_capacities, "Get an iteration's capacity for all teams in iteration and project. If a project is not specified, you will be prompted to select one.", {
|
|
308
|
+
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."),
|
|
276
309
|
iterationId: z.string().describe("The Iteration Id to get capacity for."),
|
|
277
310
|
}, async ({ project, iterationId }) => {
|
|
278
311
|
try {
|
|
279
312
|
const connection = await connectionProvider();
|
|
313
|
+
let resolvedProject = project;
|
|
314
|
+
if (!resolvedProject) {
|
|
315
|
+
const result = await elicitProject(server, connection, "Select the Azure DevOps project to get iteration capacities for.");
|
|
316
|
+
if ("response" in result)
|
|
317
|
+
return result.response;
|
|
318
|
+
resolvedProject = result.resolved;
|
|
319
|
+
}
|
|
280
320
|
const workApi = await connection.getWorkApi();
|
|
281
|
-
const rawResults = await workApi.getTotalIterationCapacities(
|
|
321
|
+
const rawResults = await workApi.getTotalIterationCapacities(resolvedProject, iterationId);
|
|
282
322
|
if (!rawResults || !rawResults.teams || rawResults.teams.length === 0) {
|
|
283
323
|
return { content: [{ type: "text", text: "No iteration capacity assigned to the teams" }], isError: true };
|
|
284
324
|
}
|
|
@@ -294,5 +334,58 @@ function configureWorkTools(server, _, connectionProvider) {
|
|
|
294
334
|
};
|
|
295
335
|
}
|
|
296
336
|
});
|
|
337
|
+
server.tool(WORK_TOOLS.get_team_settings, "Get team settings including default iteration, backlog iteration, and default area path for a team. If a project or team is not specified, you will be prompted to select one.", {
|
|
338
|
+
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."),
|
|
339
|
+
team: z.string().optional().describe("The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown."),
|
|
340
|
+
}, async ({ project, team }) => {
|
|
341
|
+
try {
|
|
342
|
+
const connection = await connectionProvider();
|
|
343
|
+
let resolvedProject = project;
|
|
344
|
+
if (!resolvedProject) {
|
|
345
|
+
const result = await elicitProject(server, connection, "Select the Azure DevOps project to get team settings for.");
|
|
346
|
+
if ("response" in result)
|
|
347
|
+
return result.response;
|
|
348
|
+
resolvedProject = result.resolved;
|
|
349
|
+
}
|
|
350
|
+
let resolvedTeam = team;
|
|
351
|
+
if (!resolvedTeam) {
|
|
352
|
+
const result = await elicitTeam(server, connection, resolvedProject, "Select the Azure DevOps team to get settings for.");
|
|
353
|
+
if ("response" in result)
|
|
354
|
+
return result.response;
|
|
355
|
+
resolvedTeam = result.resolved;
|
|
356
|
+
}
|
|
357
|
+
const workApi = await connection.getWorkApi();
|
|
358
|
+
const teamContext = { project: resolvedProject, team: resolvedTeam };
|
|
359
|
+
const teamSettings = await workApi.getTeamSettings(teamContext);
|
|
360
|
+
if (!teamSettings) {
|
|
361
|
+
return { content: [{ type: "text", text: "No team settings found" }], isError: true };
|
|
362
|
+
}
|
|
363
|
+
const teamFieldValues = await workApi.getTeamFieldValues(teamContext);
|
|
364
|
+
const result = {
|
|
365
|
+
backlogIteration: teamSettings.backlogIteration,
|
|
366
|
+
defaultIteration: teamSettings.defaultIteration,
|
|
367
|
+
defaultIterationMacro: teamSettings.defaultIterationMacro,
|
|
368
|
+
backlogVisibilities: teamSettings.backlogVisibilities,
|
|
369
|
+
bugsBehavior: teamSettings.bugsBehavior,
|
|
370
|
+
workingDays: teamSettings.workingDays,
|
|
371
|
+
defaultAreaPath: teamFieldValues?.defaultValue,
|
|
372
|
+
areaPathField: teamFieldValues?.field,
|
|
373
|
+
areaPaths: teamFieldValues?.values,
|
|
374
|
+
};
|
|
375
|
+
return {
|
|
376
|
+
content: [
|
|
377
|
+
{ type: "text", text: `Project: ${resolvedProject}, Team: ${resolvedTeam}` },
|
|
378
|
+
{ type: "text", text: JSON.stringify(result, null, 2) },
|
|
379
|
+
],
|
|
380
|
+
};
|
|
381
|
+
}
|
|
382
|
+
catch (error) {
|
|
383
|
+
const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
|
|
384
|
+
return {
|
|
385
|
+
content: [{ type: "text", text: `Error fetching team settings: ${errorMessage}` }],
|
|
386
|
+
isError: true,
|
|
387
|
+
};
|
|
388
|
+
}
|
|
389
|
+
});
|
|
297
390
|
}
|
|
298
391
|
export { WORK_TOOLS, configureWorkTools };
|
package/dist/tools.js
CHANGED
|
File without changes
|
package/dist/useragent.js
CHANGED
|
File without changes
|
package/dist/utils.js
CHANGED
|
File without changes
|
package/dist/version.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const packageVersion = "2.
|
|
1
|
+
export const packageVersion = "2.5.0-nightly.20260318";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure-devops/mcp",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.5.0-nightly.20260318",
|
|
4
4
|
"mcpName": "microsoft.com/azure-devops",
|
|
5
5
|
"description": "MCP server for interacting with Azure DevOps",
|
|
6
6
|
"license": "MIT",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"build": "tsc && shx chmod +x dist/*.js",
|
|
29
29
|
"prepare": "npm run build && husky",
|
|
30
30
|
"watch": "tsc --watch",
|
|
31
|
-
"inspect": "ALLOWED_ORIGINS=http://127.0.0.1:6274 npx @modelcontextprotocol/inspector node dist/index.js",
|
|
31
|
+
"inspect": "ALLOWED_ORIGINS=http://127.0.0.1:6274 npx @modelcontextprotocol/inspector@0.21.0 node dist/index.js",
|
|
32
32
|
"start": "node -r tsconfig-paths/register dist/index.js",
|
|
33
33
|
"eslint": "eslint",
|
|
34
34
|
"eslint-fix": "eslint --fix",
|
|
@@ -39,8 +39,8 @@
|
|
|
39
39
|
},
|
|
40
40
|
"dependencies": {
|
|
41
41
|
"@azure/identity": "^4.10.0",
|
|
42
|
-
"@azure/msal-node": "^
|
|
43
|
-
"@modelcontextprotocol/sdk": "1.
|
|
42
|
+
"@azure/msal-node": "^5.0.6",
|
|
43
|
+
"@modelcontextprotocol/sdk": "1.27.1",
|
|
44
44
|
"azure-devops-extension-api": "^4.264.0",
|
|
45
45
|
"azure-devops-extension-sdk": "^4.0.2",
|
|
46
46
|
"azure-devops-node-api": "^15.1.2",
|
|
@@ -50,7 +50,6 @@
|
|
|
50
50
|
"zod-to-json-schema": "^3.24.5"
|
|
51
51
|
},
|
|
52
52
|
"devDependencies": {
|
|
53
|
-
"@modelcontextprotocol/inspector": "^0.17.0",
|
|
54
53
|
"@types/jest": "^30.0.0",
|
|
55
54
|
"@types/node": "^22.19.1",
|
|
56
55
|
"eslint-config-prettier": "10.1.8",
|
|
@@ -60,12 +59,12 @@
|
|
|
60
59
|
"jest": "^30.0.2",
|
|
61
60
|
"jest-extended": "^7.0.0",
|
|
62
61
|
"lint-staged": "^16.2.7",
|
|
63
|
-
"prettier": "3.
|
|
62
|
+
"prettier": "3.8.1",
|
|
64
63
|
"shx": "^0.4.0",
|
|
65
64
|
"ts-jest": "^29.4.6",
|
|
66
65
|
"tsconfig-paths": "^4.2.0",
|
|
67
66
|
"typescript": "^5.9.3",
|
|
68
|
-
"typescript-eslint": "^8.
|
|
67
|
+
"typescript-eslint": "^8.54.0"
|
|
69
68
|
},
|
|
70
69
|
"lint-staged": {
|
|
71
70
|
"**/*.(js|ts|jsx|tsx|json|css|md)": [
|
package/dist/tools/builds.js
DELETED
|
@@ -1,271 +0,0 @@
|
|
|
1
|
-
// Copyright (c) Microsoft Corporation.
|
|
2
|
-
// Licensed under the MIT License.
|
|
3
|
-
import { apiVersion, getEnumKeys, safeEnumConvert } from "../utils.js";
|
|
4
|
-
import { BuildQueryOrder, DefinitionQueryOrder } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
|
|
5
|
-
import { z } from "zod";
|
|
6
|
-
import { StageUpdateType } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
|
|
7
|
-
const BUILD_TOOLS = {
|
|
8
|
-
get_builds: "build_get_builds",
|
|
9
|
-
get_changes: "build_get_changes",
|
|
10
|
-
get_definitions: "build_get_definitions",
|
|
11
|
-
get_definition_revisions: "build_get_definition_revisions",
|
|
12
|
-
get_log: "build_get_log",
|
|
13
|
-
get_log_by_id: "build_get_log_by_id",
|
|
14
|
-
get_status: "build_get_status",
|
|
15
|
-
pipelines_get_run: "pipelines_get_run",
|
|
16
|
-
pipelines_list_runs: "pipelines_list_runs",
|
|
17
|
-
pipelines_run_pipeline: "pipelines_run_pipeline",
|
|
18
|
-
update_build_stage: "build_update_build_stage",
|
|
19
|
-
};
|
|
20
|
-
function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
|
|
21
|
-
server.tool(BUILD_TOOLS.get_definitions, "Retrieves a list of build definitions for a given project.", {
|
|
22
|
-
project: z.string().describe("Project ID or name to get build definitions for"),
|
|
23
|
-
repositoryId: z.string().optional().describe("Repository ID to filter build definitions"),
|
|
24
|
-
repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter build definitions"),
|
|
25
|
-
name: z.string().optional().describe("Name of the build definition to filter"),
|
|
26
|
-
path: z.string().optional().describe("Path of the build definition to filter"),
|
|
27
|
-
queryOrder: z
|
|
28
|
-
.enum(getEnumKeys(DefinitionQueryOrder))
|
|
29
|
-
.optional()
|
|
30
|
-
.describe("Order in which build definitions are returned"),
|
|
31
|
-
top: z.number().optional().describe("Maximum number of build definitions to return"),
|
|
32
|
-
continuationToken: z.string().optional().describe("Token for continuing paged results"),
|
|
33
|
-
minMetricsTime: z.coerce.date().optional().describe("Minimum metrics time to filter build definitions"),
|
|
34
|
-
definitionIds: z.array(z.number()).optional().describe("Array of build definition IDs to filter"),
|
|
35
|
-
builtAfter: z.coerce.date().optional().describe("Return definitions that have builds after this date"),
|
|
36
|
-
notBuiltAfter: z.coerce.date().optional().describe("Return definitions that do not have builds after this date"),
|
|
37
|
-
includeAllProperties: z.boolean().optional().describe("Whether to include all properties in the results"),
|
|
38
|
-
includeLatestBuilds: z.boolean().optional().describe("Whether to include the latest builds for each definition"),
|
|
39
|
-
taskIdFilter: z.string().optional().describe("Task ID to filter build definitions"),
|
|
40
|
-
processType: z.number().optional().describe("Process type to filter build definitions"),
|
|
41
|
-
yamlFilename: z.string().optional().describe("YAML filename to filter build definitions"),
|
|
42
|
-
}, async ({ project, repositoryId, repositoryType, name, path, queryOrder, top, continuationToken, minMetricsTime, definitionIds, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename, }) => {
|
|
43
|
-
const connection = await connectionProvider();
|
|
44
|
-
const buildApi = await connection.getBuildApi();
|
|
45
|
-
const buildDefinitions = await buildApi.getDefinitions(project, name, repositoryId, repositoryType, safeEnumConvert(DefinitionQueryOrder, queryOrder), top, continuationToken, minMetricsTime, definitionIds, path, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename);
|
|
46
|
-
return {
|
|
47
|
-
content: [{ type: "text", text: JSON.stringify(buildDefinitions, null, 2) }],
|
|
48
|
-
};
|
|
49
|
-
});
|
|
50
|
-
server.tool(BUILD_TOOLS.get_definition_revisions, "Retrieves a list of revisions for a specific build definition.", {
|
|
51
|
-
project: z.string().describe("Project ID or name to get the build definition revisions for"),
|
|
52
|
-
definitionId: z.number().describe("ID of the build definition to get revisions for"),
|
|
53
|
-
}, async ({ project, definitionId }) => {
|
|
54
|
-
const connection = await connectionProvider();
|
|
55
|
-
const buildApi = await connection.getBuildApi();
|
|
56
|
-
const revisions = await buildApi.getDefinitionRevisions(project, definitionId);
|
|
57
|
-
return {
|
|
58
|
-
content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
|
|
59
|
-
};
|
|
60
|
-
});
|
|
61
|
-
server.tool(BUILD_TOOLS.get_builds, "Retrieves a list of builds for a given project.", {
|
|
62
|
-
project: z.string().describe("Project ID or name to get builds for"),
|
|
63
|
-
definitions: z.array(z.number()).optional().describe("Array of build definition IDs to filter builds"),
|
|
64
|
-
queues: z.array(z.number()).optional().describe("Array of queue IDs to filter builds"),
|
|
65
|
-
buildNumber: z.string().optional().describe("Build number to filter builds"),
|
|
66
|
-
minTime: z.coerce.date().optional().describe("Minimum finish time to filter builds"),
|
|
67
|
-
maxTime: z.coerce.date().optional().describe("Maximum finish time to filter builds"),
|
|
68
|
-
requestedFor: z.string().optional().describe("User ID or name who requested the build"),
|
|
69
|
-
reasonFilter: z.number().optional().describe("Reason filter for the build (see BuildReason enum)"),
|
|
70
|
-
statusFilter: z.number().optional().describe("Status filter for the build (see BuildStatus enum)"),
|
|
71
|
-
resultFilter: z.number().optional().describe("Result filter for the build (see BuildResult enum)"),
|
|
72
|
-
tagFilters: z.array(z.string()).optional().describe("Array of tags to filter builds"),
|
|
73
|
-
properties: z.array(z.string()).optional().describe("Array of property names to include in the results"),
|
|
74
|
-
top: z.number().optional().describe("Maximum number of builds to return"),
|
|
75
|
-
continuationToken: z.string().optional().describe("Token for continuing paged results"),
|
|
76
|
-
maxBuildsPerDefinition: z.number().optional().describe("Maximum number of builds per definition"),
|
|
77
|
-
deletedFilter: z.number().optional().describe("Filter for deleted builds (see QueryDeletedOption enum)"),
|
|
78
|
-
queryOrder: z
|
|
79
|
-
.enum(getEnumKeys(BuildQueryOrder))
|
|
80
|
-
.default("QueueTimeDescending")
|
|
81
|
-
.optional()
|
|
82
|
-
.describe("Order in which builds are returned"),
|
|
83
|
-
branchName: z.string().optional().describe("Branch name to filter builds"),
|
|
84
|
-
buildIds: z.array(z.number()).optional().describe("Array of build IDs to retrieve"),
|
|
85
|
-
repositoryId: z.string().optional().describe("Repository ID to filter builds"),
|
|
86
|
-
repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter builds"),
|
|
87
|
-
}, async ({ project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType, }) => {
|
|
88
|
-
const connection = await connectionProvider();
|
|
89
|
-
const buildApi = await connection.getBuildApi();
|
|
90
|
-
const builds = await buildApi.getBuilds(project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, safeEnumConvert(BuildQueryOrder, queryOrder), branchName, buildIds, repositoryId, repositoryType);
|
|
91
|
-
return {
|
|
92
|
-
content: [{ type: "text", text: JSON.stringify(builds, null, 2) }],
|
|
93
|
-
};
|
|
94
|
-
});
|
|
95
|
-
server.tool(BUILD_TOOLS.get_log, "Retrieves the logs for a specific build.", {
|
|
96
|
-
project: z.string().describe("Project ID or name to get the build log for"),
|
|
97
|
-
buildId: z.number().describe("ID of the build to get the log for"),
|
|
98
|
-
}, async ({ project, buildId }) => {
|
|
99
|
-
const connection = await connectionProvider();
|
|
100
|
-
const buildApi = await connection.getBuildApi();
|
|
101
|
-
const logs = await buildApi.getBuildLogs(project, buildId);
|
|
102
|
-
return {
|
|
103
|
-
content: [{ type: "text", text: JSON.stringify(logs, null, 2) }],
|
|
104
|
-
};
|
|
105
|
-
});
|
|
106
|
-
server.tool(BUILD_TOOLS.get_log_by_id, "Get a specific build log by log ID.", {
|
|
107
|
-
project: z.string().describe("Project ID or name to get the build log for"),
|
|
108
|
-
buildId: z.number().describe("ID of the build to get the log for"),
|
|
109
|
-
logId: z.number().describe("ID of the log to retrieve"),
|
|
110
|
-
startLine: z.number().optional().describe("Starting line number for the log content, defaults to 0"),
|
|
111
|
-
endLine: z.number().optional().describe("Ending line number for the log content, defaults to the end of the log"),
|
|
112
|
-
}, async ({ project, buildId, logId, startLine, endLine }) => {
|
|
113
|
-
const connection = await connectionProvider();
|
|
114
|
-
const buildApi = await connection.getBuildApi();
|
|
115
|
-
const logLines = await buildApi.getBuildLogLines(project, buildId, logId, startLine, endLine);
|
|
116
|
-
return {
|
|
117
|
-
content: [{ type: "text", text: JSON.stringify(logLines, null, 2) }],
|
|
118
|
-
};
|
|
119
|
-
});
|
|
120
|
-
server.tool(BUILD_TOOLS.get_changes, "Get the changes associated with a specific build.", {
|
|
121
|
-
project: z.string().describe("Project ID or name to get the build changes for"),
|
|
122
|
-
buildId: z.number().describe("ID of the build to get changes for"),
|
|
123
|
-
continuationToken: z.string().optional().describe("Continuation token for pagination"),
|
|
124
|
-
top: z.number().default(100).describe("Number of changes to retrieve, defaults to 100"),
|
|
125
|
-
includeSourceChange: z.boolean().optional().describe("Whether to include source changes in the results, defaults to false"),
|
|
126
|
-
}, async ({ project, buildId, continuationToken, top, includeSourceChange }) => {
|
|
127
|
-
const connection = await connectionProvider();
|
|
128
|
-
const buildApi = await connection.getBuildApi();
|
|
129
|
-
const changes = await buildApi.getBuildChanges(project, buildId, continuationToken, top, includeSourceChange);
|
|
130
|
-
return {
|
|
131
|
-
content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
|
|
132
|
-
};
|
|
133
|
-
});
|
|
134
|
-
server.tool(BUILD_TOOLS.pipelines_get_run, "Gets a run for a particular pipeline.", {
|
|
135
|
-
project: z.string().describe("Project ID or name to run the build in"),
|
|
136
|
-
pipelineId: z.number().describe("ID of the pipeline to run"),
|
|
137
|
-
runId: z.number().describe("ID of the run to get"),
|
|
138
|
-
}, async ({ project, pipelineId, runId }) => {
|
|
139
|
-
const connection = await connectionProvider();
|
|
140
|
-
const pipelinesApi = await connection.getPipelinesApi();
|
|
141
|
-
const pipelineRun = await pipelinesApi.getRun(project, pipelineId, runId);
|
|
142
|
-
return {
|
|
143
|
-
content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
|
|
144
|
-
};
|
|
145
|
-
});
|
|
146
|
-
server.tool(BUILD_TOOLS.pipelines_list_runs, "Gets top 10000 runs for a particular pipeline.", {
|
|
147
|
-
project: z.string().describe("Project ID or name to run the build in"),
|
|
148
|
-
pipelineId: z.number().describe("ID of the pipeline to run"),
|
|
149
|
-
}, async ({ project, pipelineId }) => {
|
|
150
|
-
const connection = await connectionProvider();
|
|
151
|
-
const pipelinesApi = await connection.getPipelinesApi();
|
|
152
|
-
const pipelineRuns = await pipelinesApi.listRuns(project, pipelineId);
|
|
153
|
-
return {
|
|
154
|
-
content: [{ type: "text", text: JSON.stringify(pipelineRuns, null, 2) }],
|
|
155
|
-
};
|
|
156
|
-
});
|
|
157
|
-
const variableSchema = z.object({
|
|
158
|
-
value: z.string().optional(),
|
|
159
|
-
isSecret: z.boolean().optional(),
|
|
160
|
-
});
|
|
161
|
-
const resourcesSchema = z.object({
|
|
162
|
-
builds: z
|
|
163
|
-
.record(z.string().describe("Name of the build resource."), z.object({
|
|
164
|
-
version: z.string().optional().describe("Version of the build resource."),
|
|
165
|
-
}))
|
|
166
|
-
.optional(),
|
|
167
|
-
containers: z
|
|
168
|
-
.record(z.string().describe("Name of the container resource."), z.object({
|
|
169
|
-
version: z.string().optional().describe("Version of the container resource."),
|
|
170
|
-
}))
|
|
171
|
-
.optional(),
|
|
172
|
-
packages: z
|
|
173
|
-
.record(z.string().describe("Name of the package resource."), z.object({
|
|
174
|
-
version: z.string().optional().describe("Version of the package resource."),
|
|
175
|
-
}))
|
|
176
|
-
.optional(),
|
|
177
|
-
pipelines: z.record(z.string().describe("Name of the pipeline resource."), z.object({
|
|
178
|
-
runId: z.number().describe("Id of the source pipeline run that triggered or is referenced by this pipeline run."),
|
|
179
|
-
version: z.string().optional().describe("Version of the source pipeline run."),
|
|
180
|
-
})),
|
|
181
|
-
repositories: z
|
|
182
|
-
.record(z.string().describe("Name of the repository resource."), z.object({
|
|
183
|
-
refName: z.string().describe("Reference name, e.g., refs/heads/main."),
|
|
184
|
-
token: z.string().optional(),
|
|
185
|
-
tokenType: z.string().optional(),
|
|
186
|
-
version: z.string().optional().describe("Version of the repository resource, git commit sha."),
|
|
187
|
-
}))
|
|
188
|
-
.optional(),
|
|
189
|
-
});
|
|
190
|
-
server.tool(BUILD_TOOLS.pipelines_run_pipeline, "Starts a new run of a pipeline.", {
|
|
191
|
-
project: z.string().describe("Project ID or name to run the build in"),
|
|
192
|
-
pipelineId: z.number().describe("ID of the pipeline to run"),
|
|
193
|
-
pipelineVersion: z.number().optional().describe("Version of the pipeline to run. If not provided, the latest version will be used."),
|
|
194
|
-
previewRun: z.boolean().optional().describe("If true, returns the final YAML document after parsing templates without creating a new run."),
|
|
195
|
-
resources: resourcesSchema.optional().describe("A dictionary of resources to pass to the pipeline."),
|
|
196
|
-
stagesToSkip: z.array(z.string()).optional().describe("A list of stages to skip."),
|
|
197
|
-
templateParameters: z.record(z.string(), z.string()).optional().describe("Custom build parameters as key-value pairs"),
|
|
198
|
-
variables: z.record(z.string(), variableSchema).optional().describe("A dictionary of variables to pass to the pipeline."),
|
|
199
|
-
yamlOverride: z.string().optional().describe("YAML override for the pipeline run."),
|
|
200
|
-
}, async ({ project, pipelineId, pipelineVersion, previewRun, resources, stagesToSkip, templateParameters, variables, yamlOverride }) => {
|
|
201
|
-
if (!previewRun && yamlOverride) {
|
|
202
|
-
throw new Error("Parameter 'yamlOverride' can only be specified together with parameter 'previewRun'.");
|
|
203
|
-
}
|
|
204
|
-
const connection = await connectionProvider();
|
|
205
|
-
const pipelinesApi = await connection.getPipelinesApi();
|
|
206
|
-
const runRequest = {
|
|
207
|
-
previewRun: previewRun,
|
|
208
|
-
resources: {
|
|
209
|
-
...resources,
|
|
210
|
-
},
|
|
211
|
-
stagesToSkip: stagesToSkip,
|
|
212
|
-
templateParameters: templateParameters,
|
|
213
|
-
variables: variables,
|
|
214
|
-
yamlOverride: yamlOverride,
|
|
215
|
-
};
|
|
216
|
-
const pipelineRun = await pipelinesApi.runPipeline(runRequest, project, pipelineId, pipelineVersion);
|
|
217
|
-
const queuedBuild = { id: pipelineRun.id };
|
|
218
|
-
const buildId = queuedBuild.id;
|
|
219
|
-
if (buildId === undefined) {
|
|
220
|
-
throw new Error("Failed to get build ID from pipeline run");
|
|
221
|
-
}
|
|
222
|
-
return {
|
|
223
|
-
content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
|
|
224
|
-
};
|
|
225
|
-
});
|
|
226
|
-
server.tool(BUILD_TOOLS.get_status, "Fetches the status of a specific build.", {
|
|
227
|
-
project: z.string().describe("Project ID or name to get the build status for"),
|
|
228
|
-
buildId: z.number().describe("ID of the build to get the status for"),
|
|
229
|
-
}, async ({ project, buildId }) => {
|
|
230
|
-
const connection = await connectionProvider();
|
|
231
|
-
const buildApi = await connection.getBuildApi();
|
|
232
|
-
const build = await buildApi.getBuildReport(project, buildId);
|
|
233
|
-
return {
|
|
234
|
-
content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
|
|
235
|
-
};
|
|
236
|
-
});
|
|
237
|
-
server.tool(BUILD_TOOLS.update_build_stage, "Updates the stage of a specific build.", {
|
|
238
|
-
project: z.string().describe("Project ID or name to update the build stage for"),
|
|
239
|
-
buildId: z.number().describe("ID of the build to update"),
|
|
240
|
-
stageName: z.string().describe("Name of the stage to update"),
|
|
241
|
-
status: z.enum(getEnumKeys(StageUpdateType)).describe("New status for the stage"),
|
|
242
|
-
forceRetryAllJobs: z.boolean().default(false).describe("Whether to force retry all jobs in the stage."),
|
|
243
|
-
}, async ({ project, buildId, stageName, status, forceRetryAllJobs }) => {
|
|
244
|
-
const connection = await connectionProvider();
|
|
245
|
-
const orgUrl = connection.serverUrl;
|
|
246
|
-
const endpoint = `${orgUrl}/${project}/_apis/build/builds/${buildId}/stages/${stageName}?api-version=${apiVersion}`;
|
|
247
|
-
const token = await tokenProvider();
|
|
248
|
-
const body = {
|
|
249
|
-
forceRetryAllJobs: forceRetryAllJobs,
|
|
250
|
-
state: safeEnumConvert(StageUpdateType, status),
|
|
251
|
-
};
|
|
252
|
-
const response = await fetch(endpoint, {
|
|
253
|
-
method: "PATCH",
|
|
254
|
-
headers: {
|
|
255
|
-
"Content-Type": "application/json",
|
|
256
|
-
"Authorization": `Bearer ${token.token}`,
|
|
257
|
-
"User-Agent": userAgentProvider(),
|
|
258
|
-
},
|
|
259
|
-
body: JSON.stringify(body),
|
|
260
|
-
});
|
|
261
|
-
if (!response.ok) {
|
|
262
|
-
const errorText = await response.text();
|
|
263
|
-
throw new Error(`Failed to update build stage: ${response.status} ${errorText}`);
|
|
264
|
-
}
|
|
265
|
-
const updatedBuild = await response.text();
|
|
266
|
-
return {
|
|
267
|
-
content: [{ type: "text", text: JSON.stringify(updatedBuild, null, 2) }],
|
|
268
|
-
};
|
|
269
|
-
});
|
|
270
|
-
}
|
|
271
|
-
export { BUILD_TOOLS, configureBuildTools };
|