@lotfihoc/ado-on-prem-mcp 1.0.4 → 1.0.5
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 +675 -8
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,14 +9,14 @@ Forked from [web-marketing-hr](https://www.npmjs.com/package/@web-marketing-hr/a
|
|
|
9
9
|
The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:
|
|
10
10
|
|
|
11
11
|
- "List my ADO projects"
|
|
12
|
-
- "List ADO Builds for '
|
|
13
|
-
- "List ADO Repos for '
|
|
14
|
-
- "List test plans for '
|
|
15
|
-
- "List teams for project '
|
|
16
|
-
- "List iterations for project '
|
|
17
|
-
- "List my work items for project '
|
|
18
|
-
- "List work items in current iteration for '
|
|
19
|
-
- "List all wikis in the '
|
|
12
|
+
- "List ADO Builds for 'MyProjectName'"
|
|
13
|
+
- "List ADO Repos for 'MyProjectName'"
|
|
14
|
+
- "List test plans for 'MyProjectName'"
|
|
15
|
+
- "List teams for project 'MyProjectName'"
|
|
16
|
+
- "List iterations for project 'MyProjectName'"
|
|
17
|
+
- "List my work items for project 'MyProjectName'"
|
|
18
|
+
- "List work items in current iteration for 'MyProjectName' project and 'MyProjectName Team'"
|
|
19
|
+
- "List all wikis in the 'MyProjectName' project"
|
|
20
20
|
- "Create a wiki page '/Architecture/Overview' with content about system design"
|
|
21
21
|
- "Update the wiki page '/Getting Started' with new onboarding instructions"
|
|
22
22
|
- "Get the content of the wiki page '/API/Authentication' from the Documentation wiki"
|
|
@@ -231,3 +231,670 @@ mcpServers:
|
|
|
231
231
|
```
|
|
232
232
|
|
|
233
233
|
Don't forget to create `.env` in `.continue` folder to user secrets
|
|
234
|
+
|
|
235
|
+
# Toolset
|
|
236
|
+
|
|
237
|
+
The following section provides the list of available tools you can use to interact with Azure Devops On-Premise.
|
|
238
|
+
|
|
239
|
+
## Overview
|
|
240
|
+
|
|
241
|
+
| Functional Area | Tool | Description |
|
|
242
|
+
| ----------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
243
|
+
| Advanced Security | [mcp_ado_advsec_get_alerts](#mcp_ado_advsec_get_alerts) | Retrieve Advanced Security alerts for a repository |
|
|
244
|
+
| Advanced Security | [mcp_ado_advsec_get_alert_details](#mcp_ado_advsec_get_alert_details) | Get detailed information about a specific security alert |
|
|
245
|
+
| Core | [mcp_ado_core_list_projects](#mcp_ado_core_list_projects) | List all projects in the organization |
|
|
246
|
+
| Core | [mcp_ado_core_list_project_teams](#mcp_ado_core_list_project_teams) | List teams within a project |
|
|
247
|
+
| Core | [mcp_ado_core_get_identity_ids](#mcp_ado_core_get_identity_ids) | Retrieve identity IDs by search filter |
|
|
248
|
+
| Pipelines | [mcp_ado_pipelines_create_pipeline](#mcp_ado_pipelines_create_pipeline) | Create a new pipeline with YAML configuration |
|
|
249
|
+
| Pipelines | [mcp_ado_pipelines_get_builds](#mcp_ado_pipelines_get_builds) | Retrieve a list of builds with optional filters |
|
|
250
|
+
| Pipelines | [mcp_ado_pipelines_get_build_status](#mcp_ado_pipelines_get_build_status) | Get the status of a specific build |
|
|
251
|
+
| Pipelines | [mcp_ado_pipelines_get_build_log](#mcp_ado_pipelines_get_build_log) | Retrieve complete logs for a build |
|
|
252
|
+
| Pipelines | [mcp_ado_pipelines_get_build_log_by_id](#mcp_ado_pipelines_get_build_log_by_id) | Get a specific build log by log ID |
|
|
253
|
+
| Pipelines | [mcp_ado_pipelines_get_build_changes](#mcp_ado_pipelines_get_build_changes) | Get changes (commits) associated with a build |
|
|
254
|
+
| Pipelines | [mcp_ado_pipelines_get_build_definitions](#mcp_ado_pipelines_get_build_definitions) | List build/pipeline definitions in a project |
|
|
255
|
+
| Pipelines | [mcp_ado_pipelines_get_build_definition_revisions](#mcp_ado_pipelines_get_build_definition_revisions) | Get revision history of a build definition |
|
|
256
|
+
| Pipelines | [mcp_ado_pipelines_run_pipeline](#mcp_ado_pipelines_run_pipeline) | Start a new pipeline run with optional parameters |
|
|
257
|
+
| Pipelines | [mcp_ado_pipelines_get_run](#mcp_ado_pipelines_get_run) | Get details of a specific pipeline run |
|
|
258
|
+
| Pipelines | [mcp_ado_pipelines_list_runs](#mcp_ado_pipelines_list_runs) | List recent runs for a pipeline |
|
|
259
|
+
| Pipelines | [mcp_ado_pipelines_update_build_stage](#mcp_ado_pipelines_update_build_stage) | Update a build stage (cancel, retry, or run) |
|
|
260
|
+
| Repositories | [mcp_ado_repo_list_repos_by_project](#mcp_ado_repo_list_repos_by_project) | List all repositories in a project |
|
|
261
|
+
| Repositories | [mcp_ado_repo_get_repo_by_name_or_id](#mcp_ado_repo_get_repo_by_name_or_id) | Get repository details by name or ID |
|
|
262
|
+
| Repositories | [mcp_ado_repo_list_branches_by_repo](#mcp_ado_repo_list_branches_by_repo) | List all branches in a repository |
|
|
263
|
+
| Repositories | [mcp_ado_repo_list_my_branches_by_repo](#mcp_ado_repo_list_my_branches_by_repo) | List branches created by current user |
|
|
264
|
+
| Repositories | [mcp_ado_repo_get_branch_by_name](#mcp_ado_repo_get_branch_by_name) | Get details of a specific branch |
|
|
265
|
+
| Repositories | [mcp_ado_repo_create_branch](#mcp_ado_repo_create_branch) | Create a new branch from a source branch |
|
|
266
|
+
| Repositories | [mcp_ado_repo_search_commits](#mcp_ado_repo_search_commits) | Search for commits with comprehensive filters |
|
|
267
|
+
| Repositories | [mcp_ado_repo_list_pull_requests_by_repo_or_project](#mcp_ado_repo_list_pull_requests_by_repo_or_project) | List pull requests with optional filters |
|
|
268
|
+
| Repositories | [mcp_ado_repo_list_pull_requests_by_commits](#mcp_ado_repo_list_pull_requests_by_commits) | Find pull requests containing specific commits |
|
|
269
|
+
| Repositories | [mcp_ado_repo_get_pull_request_by_id](#mcp_ado_repo_get_pull_request_by_id) | Get details of a specific pull request |
|
|
270
|
+
| Repositories | [mcp_ado_repo_create_pull_request](#mcp_ado_repo_create_pull_request) | Create a new pull request |
|
|
271
|
+
| Repositories | [mcp_ado_repo_update_pull_request](#mcp_ado_repo_update_pull_request) | Update pull request properties and settings |
|
|
272
|
+
| Repositories | [mcp_ado_repo_update_pull_request_reviewers](#mcp_ado_repo_update_pull_request_reviewers) | Add or remove reviewers from a pull request |
|
|
273
|
+
| Repositories | [mcp_ado_repo_list_pull_request_threads](#mcp_ado_repo_list_pull_request_threads) | List comment threads on a pull request |
|
|
274
|
+
| Repositories | [mcp_ado_repo_list_pull_request_thread_comments](#mcp_ado_repo_list_pull_request_thread_comments) | List comments in a specific thread |
|
|
275
|
+
| Repositories | [mcp_ado_repo_create_pull_request_thread](#mcp_ado_repo_create_pull_request_thread) | Create a new comment thread on a pull request |
|
|
276
|
+
| Repositories | [mcp_ado_repo_reply_to_comment](#mcp_ado_repo_reply_to_comment) | Reply to a pull request comment |
|
|
277
|
+
| Repositories | [mcp_ado_repo_resolve_comment](#mcp_ado_repo_resolve_comment) | Mark a comment thread as resolved |
|
|
278
|
+
| Search | [mcp_ado_search_code](#mcp_ado_search_code) | Search for code across repositories |
|
|
279
|
+
| Search | [mcp_ado_search_wiki](#mcp_ado_search_wiki) | Search wiki pages by keywords |
|
|
280
|
+
| Search | [mcp_ado_search_workitem](#mcp_ado_search_workitem) | Search work items by text and filters |
|
|
281
|
+
| Test Plans | [mcp_ado_testplan_list_test_plans](#mcp_ado_testplan_list_test_plans) | List test plans in a project |
|
|
282
|
+
| Test Plans | [mcp_ado_testplan_create_test_plan](#mcp_ado_testplan_create_test_plan) | Create a new test plan |
|
|
283
|
+
| Test Plans | [mcp_ado_testplan_list_test_suites](#mcp_ado_testplan_list_test_suites) | List test suites in a test plan |
|
|
284
|
+
| Test Plans | [mcp_ado_testplan_create_test_suite](#mcp_ado_testplan_create_test_suite) | Create a test suite within a test plan |
|
|
285
|
+
| Test Plans | [mcp_ado_testplan_add_test_cases_to_suite](#mcp_ado_testplan_add_test_cases_to_suite) | Add test cases to a test suite |
|
|
286
|
+
| Test Plans | [mcp_ado_testplan_list_test_cases](#mcp_ado_testplan_list_test_cases) | List test cases in a test suite |
|
|
287
|
+
| Test Plans | [mcp_ado_testplan_create_test_case](#mcp_ado_testplan_create_test_case) | Create a new test case work item |
|
|
288
|
+
| Test Plans | [mcp_ado_testplan_update_test_case_steps](#mcp_ado_testplan_update_test_case_steps) | Update steps of an existing test case |
|
|
289
|
+
| Test Plans | [mcp_ado_testplan_show_test_results_from_build_id](#mcp_ado_testplan_show_test_results_from_build_id) | Get test results for a specific build |
|
|
290
|
+
| Wiki | [mcp_ado_wiki_list_wikis](#mcp_ado_wiki_list_wikis) | List wikis in organization or project |
|
|
291
|
+
| Wiki | [mcp_ado_wiki_get_wiki](#mcp_ado_wiki_get_wiki) | Get details of a specific wiki |
|
|
292
|
+
| Wiki | [mcp_ado_wiki_list_pages](#mcp_ado_wiki_list_pages) | List pages in a wiki |
|
|
293
|
+
| Wiki | [mcp_ado_wiki_get_page](#mcp_ado_wiki_get_page) | Get wiki page metadata (without content) |
|
|
294
|
+
| Wiki | [mcp_ado_wiki_get_page_content](#mcp_ado_wiki_get_page_content) | Retrieve wiki page content |
|
|
295
|
+
| Wiki | [mcp_ado_wiki_create_or_update_page](#mcp_ado_wiki_create_or_update_page) | Create or update a wiki page |
|
|
296
|
+
| Work Items | [mcp_ado_wit_get_work_item](#mcp_ado_wit_get_work_item) | Get a work item by ID |
|
|
297
|
+
| Work Items | [mcp_ado_wit_get_work_items_batch_by_ids](#mcp_ado_wit_get_work_items_batch_by_ids) | Retrieve multiple work items by IDs |
|
|
298
|
+
| Work Items | [mcp_ado_wit_create_work_item](#mcp_ado_wit_create_work_item) | Create a new work item |
|
|
299
|
+
| Work Items | [mcp_ado_wit_update_work_item](#mcp_ado_wit_update_work_item) | Update fields of a work item |
|
|
300
|
+
| Work Items | [mcp_ado_wit_update_work_items_batch](#mcp_ado_wit_update_work_items_batch) | Update multiple work items in batch |
|
|
301
|
+
| Work Items | [mcp_ado_wit_add_child_work_items](#mcp_ado_wit_add_child_work_items) | Create child work items under a parent |
|
|
302
|
+
| Work Items | [mcp_ado_wit_work_items_link](#mcp_ado_wit_work_items_link) | Link work items together |
|
|
303
|
+
| Work Items | [mcp_ado_wit_work_item_unlink](#mcp_ado_wit_work_item_unlink) | Remove links from a work item |
|
|
304
|
+
| Work Items | [mcp_ado_wit_add_artifact_link](#mcp_ado_wit_add_artifact_link) | Link artifacts (commits, builds, PRs) to work items |
|
|
305
|
+
| Work Items | [mcp_ado_wit_link_work_item_to_pull_request](#mcp_ado_wit_link_work_item_to_pull_request) | Link a work item to a pull request |
|
|
306
|
+
| Work Items | [mcp_ado_wit_list_work_item_comments](#mcp_ado_wit_list_work_item_comments) | List comments on a work item |
|
|
307
|
+
| Work Items | [mcp_ado_wit_add_work_item_comment](#mcp_ado_wit_add_work_item_comment) | Add a comment to a work item |
|
|
308
|
+
| Work Items | [mcp_ado_wit_list_work_item_revisions](#mcp_ado_wit_list_work_item_revisions) | Get revision history of a work item |
|
|
309
|
+
| Work Items | [mcp_ado_wit_get_work_item_type](#mcp_ado_wit_get_work_item_type) | Get details of a work item type |
|
|
310
|
+
| Work Items | [mcp_ado_wit_my_work_items](#mcp_ado_wit_my_work_items) | List work items relevant to current user |
|
|
311
|
+
| Work Items | [mcp_ado_wit_get_work_items_for_iteration](#mcp_ado_wit_get_work_items_for_iteration) | Get work items in a specific iteration |
|
|
312
|
+
| Work Items | [mcp_ado_wit_list_backlogs](#mcp_ado_wit_list_backlogs) | List backlogs for a team |
|
|
313
|
+
| Work Items | [mcp_ado_wit_list_backlog_work_items](#mcp_ado_wit_list_backlog_work_items) | Get work items in a backlog |
|
|
314
|
+
| Work Items | [mcp_ado_wit_get_query](#mcp_ado_wit_get_query) | Get a work item query by ID or path |
|
|
315
|
+
| Work Items | [mcp_ado_wit_get_query_results_by_id](#mcp_ado_wit_get_query_results_by_id) | Execute a query and get results |
|
|
316
|
+
| Work | [mcp_ado_work_list_iterations](#mcp_ado_work_list_iterations) | List all iterations in a project |
|
|
317
|
+
| Work | [mcp_ado_work_create_iterations](#mcp_ado_work_create_iterations) | Create new iterations in a project |
|
|
318
|
+
| Work | [mcp_ado_work_list_team_iterations](#mcp_ado_work_list_team_iterations) | List iterations assigned to a team |
|
|
319
|
+
| Work | [mcp_ado_work_assign_iterations](#mcp_ado_work_assign_iterations) | Assign iterations to a team |
|
|
320
|
+
| Work | [mcp_ado_work_get_iteration_capacities](#mcp_ado_work_get_iteration_capacities) | Get capacity for all teams in an iteration |
|
|
321
|
+
| Work | [mcp_ado_work_get_team_capacity](#mcp_ado_work_get_team_capacity) | Get capacity for a specific team in iteration |
|
|
322
|
+
| Work | [mcp_ado_work_update_team_capacity](#mcp_ado_work_update_team_capacity) | Update team member capacity for iteration |
|
|
323
|
+
|
|
324
|
+
## Advanced Security
|
|
325
|
+
|
|
326
|
+
### mcp_ado_advsec_get_alerts
|
|
327
|
+
|
|
328
|
+
Retrieve Advanced Security alerts for a repository.
|
|
329
|
+
|
|
330
|
+
- **Required**: `project`, `repository`, `confidenceLevels`
|
|
331
|
+
- **Optional**: `alertType`, `continuationToken`, `onlyDefaultBranch`, `orderBy`, `ref`, `ruleId`, `ruleName`, `severities`, `states`, `toolName`, `top`, `validity`
|
|
332
|
+
|
|
333
|
+
### mcp_ado_advsec_get_alert_details
|
|
334
|
+
|
|
335
|
+
Get detailed information about a specific Advanced Security alert.
|
|
336
|
+
|
|
337
|
+
- **Required**: `project`, `repository`, `alertId`
|
|
338
|
+
- **Optional**: `ref`
|
|
339
|
+
|
|
340
|
+
## Core
|
|
341
|
+
|
|
342
|
+
### mcp_ado_core_list_projects
|
|
343
|
+
|
|
344
|
+
Retrieve a list of projects in your Azure DevOps organization.
|
|
345
|
+
|
|
346
|
+
- **Required**: None
|
|
347
|
+
- **Optional**: `continuationToken`, `projectNameFilter`, `skip`, `stateFilter`, `top`
|
|
348
|
+
|
|
349
|
+
### mcp_ado_core_list_project_teams
|
|
350
|
+
|
|
351
|
+
Retrieve a list of teams for the specified Azure DevOps project.
|
|
352
|
+
|
|
353
|
+
- **Required**: `project`
|
|
354
|
+
- **Optional**: `mine`, `skip`, `top`
|
|
355
|
+
|
|
356
|
+
### mcp_ado_core_get_identity_ids
|
|
357
|
+
|
|
358
|
+
Retrieve Azure DevOps identity IDs for a provided search filter.
|
|
359
|
+
|
|
360
|
+
- **Required**: `searchFilter`
|
|
361
|
+
- **Optional**: None
|
|
362
|
+
|
|
363
|
+
## Pipelines
|
|
364
|
+
|
|
365
|
+
### mcp_ado_pipelines_create_pipeline
|
|
366
|
+
|
|
367
|
+
Creates a pipeline definition with YAML configuration for a given project.
|
|
368
|
+
|
|
369
|
+
- **Required**: `project`, `name`, `yamlPath`, `repositoryType`, `repositoryName`
|
|
370
|
+
- **Optional**: `folder`, `repositoryConnectionId`, `repositoryId`
|
|
371
|
+
|
|
372
|
+
### mcp_ado_pipelines_get_builds
|
|
373
|
+
|
|
374
|
+
Retrieves a list of builds for a given project.
|
|
375
|
+
|
|
376
|
+
- **Required**: `project`
|
|
377
|
+
- **Optional**: `branchName`, `buildIds`, `buildNumber`, `continuationToken`, `definitions`, `deletedFilter`, `maxBuildsPerDefinition`, `maxTime`, `minTime`, `properties`, `queryOrder`, `queues`, `reasonFilter`, `repositoryId`, `repositoryType`, `requestedFor`, `resultFilter`, `statusFilter`, `tagFilters`, `top`
|
|
378
|
+
|
|
379
|
+
### mcp_ado_pipelines_get_build_status
|
|
380
|
+
|
|
381
|
+
Fetches the status of a specific build.
|
|
382
|
+
|
|
383
|
+
- **Required**: `project`, `buildId`
|
|
384
|
+
- **Optional**: None
|
|
385
|
+
|
|
386
|
+
### mcp_ado_pipelines_get_build_log
|
|
387
|
+
|
|
388
|
+
Retrieves the logs for a specific build.
|
|
389
|
+
|
|
390
|
+
- **Required**: `project`, `buildId`
|
|
391
|
+
- **Optional**: None
|
|
392
|
+
|
|
393
|
+
### mcp_ado_pipelines_get_build_log_by_id
|
|
394
|
+
|
|
395
|
+
Get a specific build log by log ID.
|
|
396
|
+
|
|
397
|
+
- **Required**: `project`, `buildId`, `logId`
|
|
398
|
+
- **Optional**: `endLine`, `startLine`
|
|
399
|
+
|
|
400
|
+
### mcp_ado_pipelines_get_build_changes
|
|
401
|
+
|
|
402
|
+
Get the changes associated with a specific build.
|
|
403
|
+
|
|
404
|
+
- **Required**: `project`, `buildId`
|
|
405
|
+
- **Optional**: `continuationToken`, `includeSourceChange`, `top`
|
|
406
|
+
|
|
407
|
+
### mcp_ado_pipelines_get_build_definitions
|
|
408
|
+
|
|
409
|
+
Retrieves a list of build definitions for a given project.
|
|
410
|
+
|
|
411
|
+
- **Required**: `project`
|
|
412
|
+
- **Optional**: `builtAfter`, `continuationToken`, `definitionIds`, `includeAllProperties`, `includeLatestBuilds`, `minMetricsTime`, `name`, `notBuiltAfter`, `path`, `processType`, `queryOrder`, `repositoryId`, `repositoryType`, `taskIdFilter`, `top`, `yamlFilename`
|
|
413
|
+
|
|
414
|
+
### mcp_ado_pipelines_get_build_definition_revisions
|
|
415
|
+
|
|
416
|
+
Retrieves a list of revisions for a specific build definition.
|
|
417
|
+
|
|
418
|
+
- **Required**: `project`, `definitionId`
|
|
419
|
+
- **Optional**: None
|
|
420
|
+
|
|
421
|
+
### mcp_ado_pipelines_run_pipeline
|
|
422
|
+
|
|
423
|
+
Starts a new run of a pipeline.
|
|
424
|
+
|
|
425
|
+
- **Required**: `project`, `pipelineId`
|
|
426
|
+
- **Optional**: `pipelineVersion`, `previewRun`, `resources`, `stagesToSkip`, `templateParameters`, `variables`, `yamlOverride`
|
|
427
|
+
|
|
428
|
+
### mcp_ado_pipelines_get_run
|
|
429
|
+
|
|
430
|
+
Gets a run for a particular pipeline.
|
|
431
|
+
|
|
432
|
+
- **Required**: `project`, `pipelineId`, `runId`
|
|
433
|
+
- **Optional**: None
|
|
434
|
+
|
|
435
|
+
### mcp_ado_pipelines_list_runs
|
|
436
|
+
|
|
437
|
+
Gets top 10000 runs for a particular pipeline.
|
|
438
|
+
|
|
439
|
+
- **Required**: `project`, `pipelineId`
|
|
440
|
+
- **Optional**: None
|
|
441
|
+
|
|
442
|
+
### mcp_ado_pipelines_update_build_stage
|
|
443
|
+
|
|
444
|
+
Updates the stage of a specific build.
|
|
445
|
+
|
|
446
|
+
- **Required**: `project`, `buildId`, `stageName`, `status`
|
|
447
|
+
- **Optional**: `forceRetryAllJobs`
|
|
448
|
+
|
|
449
|
+
## Repositories
|
|
450
|
+
|
|
451
|
+
### mcp_ado_repo_list_repos_by_project
|
|
452
|
+
|
|
453
|
+
Retrieve a list of repositories for a given project.
|
|
454
|
+
|
|
455
|
+
- **Required**: `project`
|
|
456
|
+
- **Optional**: `repoNameFilter`, `skip`, `top`
|
|
457
|
+
|
|
458
|
+
### mcp_ado_repo_get_repo_by_name_or_id
|
|
459
|
+
|
|
460
|
+
Get the repository by project and repository name or ID.
|
|
461
|
+
|
|
462
|
+
- **Required**: `project`, `repositoryNameOrId`
|
|
463
|
+
- **Optional**: None
|
|
464
|
+
|
|
465
|
+
### mcp_ado_repo_list_branches_by_repo
|
|
466
|
+
|
|
467
|
+
Retrieve a list of branches for a given repository.
|
|
468
|
+
|
|
469
|
+
- **Required**: `repositoryId`
|
|
470
|
+
- **Optional**: `filterContains`, `top`
|
|
471
|
+
|
|
472
|
+
### mcp_ado_repo_list_my_branches_by_repo
|
|
473
|
+
|
|
474
|
+
Retrieve a list of my branches for a given repository Id.
|
|
475
|
+
|
|
476
|
+
- **Required**: `repositoryId`
|
|
477
|
+
- **Optional**: `filterContains`, `top`
|
|
478
|
+
|
|
479
|
+
### mcp_ado_repo_get_branch_by_name
|
|
480
|
+
|
|
481
|
+
Get a branch by its name.
|
|
482
|
+
|
|
483
|
+
- **Required**: `repositoryId`, `branchName`
|
|
484
|
+
- **Optional**: None
|
|
485
|
+
|
|
486
|
+
### mcp_ado_repo_create_branch
|
|
487
|
+
|
|
488
|
+
Create a new branch in the repository.
|
|
489
|
+
|
|
490
|
+
- **Required**: `repositoryId`, `branchName`
|
|
491
|
+
- **Optional**: `sourceBranchName`, `sourceCommitId`
|
|
492
|
+
|
|
493
|
+
### mcp_ado_repo_search_commits
|
|
494
|
+
|
|
495
|
+
Search for commits in a repository with comprehensive filtering capabilities.
|
|
496
|
+
|
|
497
|
+
- **Required**: `project`, `repository`
|
|
498
|
+
- **Optional**: `author`, `authorEmail`, `commitIds`, `committer`, `committerEmail`, `fromCommit`, `fromDate`, `historySimplificationMode`, `includeLinks`, `includeWorkItems`, `searchText`, `skip`, `toCommit`, `toDate`, `top`, `version`, `versionType`
|
|
499
|
+
|
|
500
|
+
### mcp_ado_repo_list_pull_requests_by_repo_or_project
|
|
501
|
+
|
|
502
|
+
Retrieve a list of pull requests for a given repository.
|
|
503
|
+
|
|
504
|
+
- **Required**: None (either `repositoryId` or `project` must be provided)
|
|
505
|
+
- **Optional**: `created_by_me`, `created_by_user`, `i_am_reviewer`, `project`, `repositoryId`, `skip`, `sourceRefName`, `status`, `targetRefName`, `top`, `user_is_reviewer`
|
|
506
|
+
|
|
507
|
+
### mcp_ado_repo_list_pull_requests_by_commits
|
|
508
|
+
|
|
509
|
+
Lists pull requests by commit IDs to find which pull requests contain specific commits.
|
|
510
|
+
|
|
511
|
+
- **Required**: `project`, `repository`, `commits`
|
|
512
|
+
- **Optional**: `queryType`
|
|
513
|
+
|
|
514
|
+
### mcp_ado_repo_get_pull_request_by_id
|
|
515
|
+
|
|
516
|
+
Get a pull request by its ID.
|
|
517
|
+
|
|
518
|
+
- **Required**: `repositoryId`, `pullRequestId`
|
|
519
|
+
- **Optional**: `includeWorkItemRefs`
|
|
520
|
+
|
|
521
|
+
### mcp_ado_repo_create_pull_request
|
|
522
|
+
|
|
523
|
+
Create a new pull request.
|
|
524
|
+
|
|
525
|
+
- **Required**: `repositoryId`, `sourceRefName`, `targetRefName`, `title`
|
|
526
|
+
- **Optional**: `description`, `forkSourceRepositoryId`, `isDraft`, `labels`, `workItems`
|
|
527
|
+
|
|
528
|
+
### mcp_ado_repo_update_pull_request
|
|
529
|
+
|
|
530
|
+
Update a Pull Request by ID with specified fields.
|
|
531
|
+
|
|
532
|
+
- **Required**: `repositoryId`, `pullRequestId`
|
|
533
|
+
- **Optional**: `autoComplete`, `bypassReason`, `deleteSourceBranch`, `description`, `isDraft`, `mergeStrategy`, `status`, `targetRefName`, `title`, `transitionWorkItems`
|
|
534
|
+
|
|
535
|
+
### mcp_ado_repo_update_pull_request_reviewers
|
|
536
|
+
|
|
537
|
+
Add or remove reviewers for an existing pull request.
|
|
538
|
+
|
|
539
|
+
- **Required**: `repositoryId`, `pullRequestId`, `reviewerIds`, `action`
|
|
540
|
+
- **Optional**: None
|
|
541
|
+
|
|
542
|
+
### mcp_ado_repo_list_pull_request_threads
|
|
543
|
+
|
|
544
|
+
Retrieve a list of comment threads for a pull request.
|
|
545
|
+
|
|
546
|
+
- **Required**: `repositoryId`, `pullRequestId`
|
|
547
|
+
- **Optional**: `baseIteration`, `fullResponse`, `iteration`, `project`, `skip`, `top`
|
|
548
|
+
|
|
549
|
+
### mcp_ado_repo_list_pull_request_thread_comments
|
|
550
|
+
|
|
551
|
+
Retrieve a list of comments in a pull request thread.
|
|
552
|
+
|
|
553
|
+
- **Required**: `repositoryId`, `pullRequestId`, `threadId`
|
|
554
|
+
- **Optional**: `fullResponse`, `project`, `skip`, `top`
|
|
555
|
+
|
|
556
|
+
### mcp_ado_repo_create_pull_request_thread
|
|
557
|
+
|
|
558
|
+
Creates a new comment thread on a pull request.
|
|
559
|
+
|
|
560
|
+
- **Required**: `repositoryId`, `pullRequestId`, `content`
|
|
561
|
+
- **Optional**: `filePath`, `project`, `rightFileEndLine`, `rightFileEndOffset`, `rightFileStartLine`, `rightFileStartOffset`, `status`
|
|
562
|
+
|
|
563
|
+
### mcp_ado_repo_reply_to_comment
|
|
564
|
+
|
|
565
|
+
Replies to a specific comment on a pull request.
|
|
566
|
+
|
|
567
|
+
- **Required**: `repositoryId`, `pullRequestId`, `threadId`, `content`
|
|
568
|
+
- **Optional**: `fullResponse`, `project`
|
|
569
|
+
|
|
570
|
+
### mcp_ado_repo_resolve_comment
|
|
571
|
+
|
|
572
|
+
Resolves a specific comment thread on a pull request.
|
|
573
|
+
|
|
574
|
+
- **Required**: `repositoryId`, `pullRequestId`, `threadId`
|
|
575
|
+
- **Optional**: `fullResponse`
|
|
576
|
+
|
|
577
|
+
## Search
|
|
578
|
+
|
|
579
|
+
### mcp_ado_search_code
|
|
580
|
+
|
|
581
|
+
Search Azure DevOps Repositories for a given search text.
|
|
582
|
+
|
|
583
|
+
- **Required**: `searchText`
|
|
584
|
+
- **Optional**: `branch`, `includeFacets`, `path`, `project`, `repository`, `skip`, `top`
|
|
585
|
+
|
|
586
|
+
### mcp_ado_search_wiki
|
|
587
|
+
|
|
588
|
+
Search Azure DevOps Wiki for a given search text.
|
|
589
|
+
|
|
590
|
+
- **Required**: `searchText`
|
|
591
|
+
- **Optional**: `includeFacets`, `project`, `skip`, `top`, `wiki`
|
|
592
|
+
|
|
593
|
+
### mcp_ado_search_workitem
|
|
594
|
+
|
|
595
|
+
Get Azure DevOps Work Item search results for a given search text.
|
|
596
|
+
|
|
597
|
+
- **Required**: `searchText`
|
|
598
|
+
- **Optional**: `areaPath`, `assignedTo`, `includeFacets`, `project`, `skip`, `state`, `top`, `workItemType`
|
|
599
|
+
|
|
600
|
+
## Test Plans
|
|
601
|
+
|
|
602
|
+
### mcp_ado_testplan_list_test_plans
|
|
603
|
+
|
|
604
|
+
Retrieve a paginated list of test plans from an Azure DevOps project.
|
|
605
|
+
|
|
606
|
+
- **Required**: `project`
|
|
607
|
+
- **Optional**: `continuationToken`, `filterActivePlans`, `includePlanDetails`
|
|
608
|
+
|
|
609
|
+
### mcp_ado_testplan_create_test_plan
|
|
610
|
+
|
|
611
|
+
Creates a new test plan in the project.
|
|
612
|
+
|
|
613
|
+
- **Required**: `project`, `name`, `iteration`
|
|
614
|
+
- **Optional**: `areaPath`, `description`, `endDate`, `startDate`
|
|
615
|
+
|
|
616
|
+
### mcp_ado_testplan_list_test_suites
|
|
617
|
+
|
|
618
|
+
Retrieve a paginated list of test suites from an Azure DevOps project and Test Plan Id. Returns test suites in a properly nested hierarchical structure.
|
|
619
|
+
|
|
620
|
+
- **Required**: `project`, `planId`
|
|
621
|
+
- **Optional**: `continuationToken`
|
|
622
|
+
|
|
623
|
+
### mcp_ado_testplan_create_test_suite
|
|
624
|
+
|
|
625
|
+
Creates a new test suite in a test plan.
|
|
626
|
+
|
|
627
|
+
- **Required**: `project`, `planId`, `parentSuiteId`, `name`
|
|
628
|
+
- **Optional**: None
|
|
629
|
+
|
|
630
|
+
### mcp_ado_testplan_add_test_cases_to_suite
|
|
631
|
+
|
|
632
|
+
Adds existing test cases to a test suite.
|
|
633
|
+
|
|
634
|
+
- **Required**: `project`, `planId`, `suiteId`, `testCaseIds`
|
|
635
|
+
- **Optional**: None
|
|
636
|
+
|
|
637
|
+
### mcp_ado_testplan_list_test_cases
|
|
638
|
+
|
|
639
|
+
Gets a list of test cases in the test plan.
|
|
640
|
+
|
|
641
|
+
- **Required**: `project`, `planid`, `suiteid`
|
|
642
|
+
- **Optional**: None
|
|
643
|
+
|
|
644
|
+
### mcp_ado_testplan_create_test_case
|
|
645
|
+
|
|
646
|
+
Creates a new test case work item.
|
|
647
|
+
|
|
648
|
+
- **Required**: `project`, `title`
|
|
649
|
+
- **Optional**: `areaPath`, `iterationPath`, `priority`, `steps`, `testsWorkItemId`
|
|
650
|
+
|
|
651
|
+
### mcp_ado_testplan_update_test_case_steps
|
|
652
|
+
|
|
653
|
+
Update an existing test case work item.
|
|
654
|
+
|
|
655
|
+
- **Required**: `id`, `steps`
|
|
656
|
+
- **Optional**: None
|
|
657
|
+
|
|
658
|
+
### mcp_ado_testplan_show_test_results_from_build_id
|
|
659
|
+
|
|
660
|
+
Gets a list of test results for a given project and build ID.
|
|
661
|
+
|
|
662
|
+
- **Required**: `project`, `buildid`
|
|
663
|
+
- **Optional**: None
|
|
664
|
+
|
|
665
|
+
## Wiki
|
|
666
|
+
|
|
667
|
+
### mcp_ado_wiki_list_wikis
|
|
668
|
+
|
|
669
|
+
Retrieve a list of wikis for an organization or project.
|
|
670
|
+
|
|
671
|
+
- **Required**: None
|
|
672
|
+
- **Optional**: `project`
|
|
673
|
+
|
|
674
|
+
### mcp_ado_wiki_get_wiki
|
|
675
|
+
|
|
676
|
+
Get the wiki by wikiIdentifier.
|
|
677
|
+
|
|
678
|
+
- **Required**: `wikiIdentifier`
|
|
679
|
+
- **Optional**: `project`
|
|
680
|
+
|
|
681
|
+
### mcp_ado_wiki_list_pages
|
|
682
|
+
|
|
683
|
+
Retrieve a list of wiki pages for a specific wiki and project.
|
|
684
|
+
|
|
685
|
+
- **Required**: `wikiIdentifier`, `project`
|
|
686
|
+
- **Optional**: `continuationToken`, `pageViewsForDays`, `top`
|
|
687
|
+
|
|
688
|
+
### mcp_ado_wiki_get_page
|
|
689
|
+
|
|
690
|
+
Retrieve wiki page metadata by path. This tool does not return page content.
|
|
691
|
+
|
|
692
|
+
- **Required**: `wikiIdentifier`, `project`, `path`
|
|
693
|
+
- **Optional**: `recursionLevel`
|
|
694
|
+
|
|
695
|
+
### mcp_ado_wiki_get_page_content
|
|
696
|
+
|
|
697
|
+
Retrieve wiki page content.
|
|
698
|
+
|
|
699
|
+
- **Required**: None (either `url` OR `wikiIdentifier` and `project`)
|
|
700
|
+
- **Optional**: `path`, `project`, `url`, `wikiIdentifier`
|
|
701
|
+
|
|
702
|
+
### mcp_ado_wiki_create_or_update_page
|
|
703
|
+
|
|
704
|
+
Create or update a wiki page with content.
|
|
705
|
+
|
|
706
|
+
- **Required**: `wikiIdentifier`, `path`, `content`
|
|
707
|
+
- **Optional**: `branch`, `etag`, `project`
|
|
708
|
+
|
|
709
|
+
## Work Items
|
|
710
|
+
|
|
711
|
+
### mcp_ado_wit_get_work_item
|
|
712
|
+
|
|
713
|
+
Get a single work item by ID.
|
|
714
|
+
|
|
715
|
+
- **Required**: `id`, `project`
|
|
716
|
+
- **Optional**: `asOf`, `expand`, `fields`
|
|
717
|
+
|
|
718
|
+
### mcp_ado_wit_get_work_items_batch_by_ids
|
|
719
|
+
|
|
720
|
+
Retrieve list of work items by IDs in batch.
|
|
721
|
+
|
|
722
|
+
- **Required**: `project`, `ids`
|
|
723
|
+
- **Optional**: `fields`
|
|
724
|
+
|
|
725
|
+
### mcp_ado_wit_create_work_item
|
|
726
|
+
|
|
727
|
+
Create a new work item in a specified project and work item type.
|
|
728
|
+
|
|
729
|
+
- **Required**: `project`, `workItemType`, `fields`
|
|
730
|
+
- **Optional**: None
|
|
731
|
+
|
|
732
|
+
### mcp_ado_wit_update_work_item
|
|
733
|
+
|
|
734
|
+
Update a work item by ID with specified fields.
|
|
735
|
+
|
|
736
|
+
- **Required**: `id`, `updates`
|
|
737
|
+
- **Optional**: None
|
|
738
|
+
|
|
739
|
+
### mcp_ado_wit_update_work_items_batch
|
|
740
|
+
|
|
741
|
+
Update work items in batch.
|
|
742
|
+
|
|
743
|
+
- **Required**: `updates`
|
|
744
|
+
- **Optional**: None
|
|
745
|
+
|
|
746
|
+
### mcp_ado_wit_add_child_work_items
|
|
747
|
+
|
|
748
|
+
Create one or many child work items from a parent by work item type and parent id.
|
|
749
|
+
|
|
750
|
+
- **Required**: `parentId`, `project`, `workItemType`, `items`
|
|
751
|
+
- **Optional**: None
|
|
752
|
+
|
|
753
|
+
### mcp_ado_wit_work_items_link
|
|
754
|
+
|
|
755
|
+
Link work items together in batch.
|
|
756
|
+
|
|
757
|
+
- **Required**: `project`, `updates`
|
|
758
|
+
- **Optional**: None
|
|
759
|
+
|
|
760
|
+
### mcp_ado_wit_work_item_unlink
|
|
761
|
+
|
|
762
|
+
Remove one or many links from a single work item.
|
|
763
|
+
|
|
764
|
+
- **Required**: `project`, `id`
|
|
765
|
+
- **Optional**: `type`, `url`
|
|
766
|
+
|
|
767
|
+
### mcp_ado_wit_add_artifact_link
|
|
768
|
+
|
|
769
|
+
Add artifact links (repository, branch, commit, builds) to work items.
|
|
770
|
+
|
|
771
|
+
- **Required**: `workItemId`, `project`
|
|
772
|
+
- **Optional**: `artifactUri`, `branchName`, `buildId`, `comment`, `commitId`, `linkType`, `projectId`, `pullRequestId`, `repositoryId`
|
|
773
|
+
|
|
774
|
+
### mcp_ado_wit_link_work_item_to_pull_request
|
|
775
|
+
|
|
776
|
+
Link a single work item to an existing pull request.
|
|
777
|
+
|
|
778
|
+
- **Required**: `projectId`, `repositoryId`, `pullRequestId`, `workItemId`
|
|
779
|
+
- **Optional**: `pullRequestProjectId`
|
|
780
|
+
|
|
781
|
+
### mcp_ado_wit_list_work_item_comments
|
|
782
|
+
|
|
783
|
+
Retrieve list of comments for a work item by ID.
|
|
784
|
+
|
|
785
|
+
- **Required**: `project`, `workItemId`
|
|
786
|
+
- **Optional**: `top`
|
|
787
|
+
|
|
788
|
+
### mcp_ado_wit_add_work_item_comment
|
|
789
|
+
|
|
790
|
+
Add comment to a work item by ID.
|
|
791
|
+
|
|
792
|
+
- **Required**: `project`, `workItemId`, `comment`
|
|
793
|
+
- **Optional**: `format`
|
|
794
|
+
|
|
795
|
+
### mcp_ado_wit_list_work_item_revisions
|
|
796
|
+
|
|
797
|
+
Retrieve list of revisions for a work item by ID.
|
|
798
|
+
|
|
799
|
+
- **Required**: `project`, `workItemId`
|
|
800
|
+
- **Optional**: `expand`, `skip`, `top`
|
|
801
|
+
|
|
802
|
+
### mcp_ado_wit_get_work_item_type
|
|
803
|
+
|
|
804
|
+
Get a specific work item type.
|
|
805
|
+
|
|
806
|
+
- **Required**: `project`, `workItemType`
|
|
807
|
+
- **Optional**: None
|
|
808
|
+
|
|
809
|
+
### mcp_ado_wit_my_work_items
|
|
810
|
+
|
|
811
|
+
Retrieve a list of work items relevant to the authenticated user.
|
|
812
|
+
|
|
813
|
+
- **Required**: `project`
|
|
814
|
+
- **Optional**: `includeCompleted`, `top`, `type`
|
|
815
|
+
|
|
816
|
+
### mcp_ado_wit_get_work_items_for_iteration
|
|
817
|
+
|
|
818
|
+
Retrieve a list of work items for a specified iteration.
|
|
819
|
+
|
|
820
|
+
- **Required**: `project`, `iterationId`
|
|
821
|
+
- **Optional**: `team`
|
|
822
|
+
|
|
823
|
+
### mcp_ado_wit_list_backlogs
|
|
824
|
+
|
|
825
|
+
Receive a list of backlogs for a given project and team.
|
|
826
|
+
|
|
827
|
+
- **Required**: `project`, `team`
|
|
828
|
+
- **Optional**: None
|
|
829
|
+
|
|
830
|
+
### mcp_ado_wit_list_backlog_work_items
|
|
831
|
+
|
|
832
|
+
Retrieve a list of backlogs for a given project, team, and backlog category.
|
|
833
|
+
|
|
834
|
+
- **Required**: `project`, `team`, `backlogId`
|
|
835
|
+
- **Optional**: None
|
|
836
|
+
|
|
837
|
+
### mcp_ado_wit_get_query
|
|
838
|
+
|
|
839
|
+
Get a query by its ID or path.
|
|
840
|
+
|
|
841
|
+
- **Required**: `project`, `query`
|
|
842
|
+
- **Optional**: `depth`, `expand`, `includeDeleted`, `useIsoDateFormat`
|
|
843
|
+
|
|
844
|
+
### mcp_ado_wit_get_query_results_by_id
|
|
845
|
+
|
|
846
|
+
Retrieve the results of a work item query given the query ID.
|
|
847
|
+
|
|
848
|
+
- **Required**: `id`
|
|
849
|
+
- **Optional**: `project`, `responseType`, `team`, `timePrecision`, `top`
|
|
850
|
+
|
|
851
|
+
## Work
|
|
852
|
+
|
|
853
|
+
### mcp_ado_work_list_iterations
|
|
854
|
+
|
|
855
|
+
List all iterations in a specified Azure DevOps project.
|
|
856
|
+
|
|
857
|
+
- **Required**: `project`
|
|
858
|
+
- **Optional**: `depth`, `excludedIds`
|
|
859
|
+
|
|
860
|
+
### mcp_ado_work_create_iterations
|
|
861
|
+
|
|
862
|
+
Create new iterations in a specified Azure DevOps project.
|
|
863
|
+
|
|
864
|
+
- **Required**: `project`, `iterations`
|
|
865
|
+
- **Optional**: None
|
|
866
|
+
|
|
867
|
+
### mcp_ado_work_list_team_iterations
|
|
868
|
+
|
|
869
|
+
Retrieve a list of iterations for a specific team in a project.
|
|
870
|
+
|
|
871
|
+
- **Required**: `project`, `team`
|
|
872
|
+
- **Optional**: `timeframe`
|
|
873
|
+
|
|
874
|
+
### mcp_ado_work_assign_iterations
|
|
875
|
+
|
|
876
|
+
Assign existing iterations to a specific team in a project.
|
|
877
|
+
|
|
878
|
+
- **Required**: `project`, `team`, `iterations`
|
|
879
|
+
- **Optional**: None
|
|
880
|
+
|
|
881
|
+
### mcp_ado_work_get_iteration_capacities
|
|
882
|
+
|
|
883
|
+
Get an iteration's capacity for all teams in iteration and project.
|
|
884
|
+
|
|
885
|
+
- **Required**: `project`, `iterationId`
|
|
886
|
+
- **Optional**: None
|
|
887
|
+
|
|
888
|
+
### mcp_ado_work_get_team_capacity
|
|
889
|
+
|
|
890
|
+
Get the team capacity of a specific team and iteration in a project.
|
|
891
|
+
|
|
892
|
+
- **Required**: `project`, `team`, `iterationId`
|
|
893
|
+
- **Optional**: None
|
|
894
|
+
|
|
895
|
+
### mcp_ado_work_update_team_capacity
|
|
896
|
+
|
|
897
|
+
Update the team capacity of a team member for a specific iteration in a project.
|
|
898
|
+
|
|
899
|
+
- **Required**: `project`, `team`, `teamMemberId`, `iterationId`, `activities`
|
|
900
|
+
- **Optional**: `daysOff`
|
package/dist/version.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export const packageVersion = "1.0.
|
|
1
|
+
export const packageVersion = "1.0.05";
|
|
2
2
|
//# sourceMappingURL=version.js.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lotfihoc/ado-on-prem-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.05",
|
|
4
4
|
"description": "MCP server for interacting with Azure DevOps (on-premises) WEM fork",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Microsoft Corporation, WEB Marketing d.o.o. Fork, Lotfi Hoc",
|