@aqajooon/mcp-server-azure-devops 0.0.0-stage → 0.1.55
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/LICENSE +21 -0
- package/README.md +318 -2
- package/dist/clients/azure-devops.d.ts +105 -0
- package/dist/clients/azure-devops.js +501 -0
- package/dist/clients/azure-devops.js.map +1 -0
- package/dist/features/environments/feature.d.ts +24 -0
- package/dist/features/environments/feature.js +48 -0
- package/dist/features/environments/feature.js.map +1 -0
- package/dist/features/environments/index.d.ts +10 -0
- package/dist/features/environments/index.js +42 -0
- package/dist/features/environments/index.js.map +1 -0
- package/dist/features/environments/schema.d.ts +7 -0
- package/dist/features/environments/schema.js +28 -0
- package/dist/features/environments/schema.js.map +1 -0
- package/dist/features/libraries/feature.d.ts +27 -0
- package/dist/features/libraries/feature.js +47 -0
- package/dist/features/libraries/feature.js.map +1 -0
- package/dist/features/libraries/index.d.ts +10 -0
- package/dist/features/libraries/index.js +42 -0
- package/dist/features/libraries/index.js.map +1 -0
- package/dist/features/libraries/schema.d.ts +7 -0
- package/dist/features/libraries/schema.js +27 -0
- package/dist/features/libraries/schema.js.map +1 -0
- package/dist/features/organizations/__test__/test-helpers.d.ts +13 -0
- package/dist/features/organizations/__test__/test-helpers.js +38 -0
- package/dist/features/organizations/__test__/test-helpers.js.map +1 -0
- package/dist/features/organizations/index.d.ts +13 -0
- package/dist/features/organizations/index.js +63 -0
- package/dist/features/organizations/index.js.map +1 -0
- package/dist/features/organizations/list-organizations/feature.d.ts +13 -0
- package/dist/features/organizations/list-organizations/feature.js +101 -0
- package/dist/features/organizations/list-organizations/feature.js.map +1 -0
- package/dist/features/organizations/list-organizations/index.d.ts +2 -0
- package/dist/features/organizations/list-organizations/index.js +19 -0
- package/dist/features/organizations/list-organizations/index.js.map +1 -0
- package/dist/features/organizations/list-organizations/schema.d.ts +2 -0
- package/dist/features/organizations/list-organizations/schema.js +6 -0
- package/dist/features/organizations/list-organizations/schema.js.map +1 -0
- package/dist/features/organizations/schemas.d.ts +6 -0
- package/dist/features/organizations/schemas.js +10 -0
- package/dist/features/organizations/schemas.js.map +1 -0
- package/dist/features/organizations/tool-definitions.d.ts +5 -0
- package/dist/features/organizations/tool-definitions.js +16 -0
- package/dist/features/organizations/tool-definitions.js.map +1 -0
- package/dist/features/organizations/types.d.ts +21 -0
- package/dist/features/organizations/types.js +8 -0
- package/dist/features/organizations/types.js.map +1 -0
- package/dist/features/pipelines/artifacts.d.ts +11 -0
- package/dist/features/pipelines/artifacts.js +288 -0
- package/dist/features/pipelines/artifacts.js.map +1 -0
- package/dist/features/pipelines/download-pipeline-artifact/feature.d.ts +3 -0
- package/dist/features/pipelines/download-pipeline-artifact/feature.js +222 -0
- package/dist/features/pipelines/download-pipeline-artifact/feature.js.map +1 -0
- package/dist/features/pipelines/download-pipeline-artifact/index.d.ts +2 -0
- package/dist/features/pipelines/download-pipeline-artifact/index.js +19 -0
- package/dist/features/pipelines/download-pipeline-artifact/index.js.map +1 -0
- package/dist/features/pipelines/download-pipeline-artifact/schema.d.ts +7 -0
- package/dist/features/pipelines/download-pipeline-artifact/schema.js +23 -0
- package/dist/features/pipelines/download-pipeline-artifact/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline/feature.d.ts +10 -0
- package/dist/features/pipelines/get-pipeline/feature.js +46 -0
- package/dist/features/pipelines/get-pipeline/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline/index.js +19 -0
- package/dist/features/pipelines/get-pipeline/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline/schema.d.ts +9 -0
- package/dist/features/pipelines/get-pipeline/schema.js +29 -0
- package/dist/features/pipelines/get-pipeline/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-log/feature.d.ts +3 -0
- package/dist/features/pipelines/get-pipeline-log/feature.js +57 -0
- package/dist/features/pipelines/get-pipeline-log/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-log/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline-log/index.js +19 -0
- package/dist/features/pipelines/get-pipeline-log/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-log/schema.d.ts +13 -0
- package/dist/features/pipelines/get-pipeline-log/schema.js +40 -0
- package/dist/features/pipelines/get-pipeline-log/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run/feature.d.ts +3 -0
- package/dist/features/pipelines/get-pipeline-run/feature.js +76 -0
- package/dist/features/pipelines/get-pipeline-run/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline-run/index.js +19 -0
- package/dist/features/pipelines/get-pipeline-run/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run/schema.d.ts +6 -0
- package/dist/features/pipelines/get-pipeline-run/schema.js +19 -0
- package/dist/features/pipelines/get-pipeline-run/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-sources/feature.d.ts +26 -0
- package/dist/features/pipelines/get-pipeline-run-sources/feature.js +105 -0
- package/dist/features/pipelines/get-pipeline-run-sources/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-sources/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline-run-sources/index.js +19 -0
- package/dist/features/pipelines/get-pipeline-run-sources/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-sources/schema.d.ts +6 -0
- package/dist/features/pipelines/get-pipeline-run-sources/schema.js +19 -0
- package/dist/features/pipelines/get-pipeline-run-sources/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/feature.d.ts +47 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/feature.js +185 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/index.js +19 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/schema.d.ts +7 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/schema.js +21 -0
- package/dist/features/pipelines/get-pipeline-run-stage-tasks/schema.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/feature.d.ts +41 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/feature.js +450 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/feature.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/index.d.ts +2 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/index.js +19 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/index.js.map +1 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/schema.d.ts +6 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/schema.js +19 -0
- package/dist/features/pipelines/get-pipeline-run-yaml/schema.js.map +1 -0
- package/dist/features/pipelines/helpers.d.ts +3 -0
- package/dist/features/pipelines/helpers.js +29 -0
- package/dist/features/pipelines/helpers.js.map +1 -0
- package/dist/features/pipelines/index.d.ts +22 -0
- package/dist/features/pipelines/index.js +216 -0
- package/dist/features/pipelines/index.js.map +1 -0
- package/dist/features/pipelines/list-pipeline-runs/feature.d.ts +3 -0
- package/dist/features/pipelines/list-pipeline-runs/feature.js +98 -0
- package/dist/features/pipelines/list-pipeline-runs/feature.js.map +1 -0
- package/dist/features/pipelines/list-pipeline-runs/index.d.ts +2 -0
- package/dist/features/pipelines/list-pipeline-runs/index.js +19 -0
- package/dist/features/pipelines/list-pipeline-runs/index.js.map +1 -0
- package/dist/features/pipelines/list-pipeline-runs/schema.d.ts +28 -0
- package/dist/features/pipelines/list-pipeline-runs/schema.js +50 -0
- package/dist/features/pipelines/list-pipeline-runs/schema.js.map +1 -0
- package/dist/features/pipelines/list-pipelines/feature.d.ts +10 -0
- package/dist/features/pipelines/list-pipelines/feature.js +42 -0
- package/dist/features/pipelines/list-pipelines/feature.js.map +1 -0
- package/dist/features/pipelines/list-pipelines/index.d.ts +2 -0
- package/dist/features/pipelines/list-pipelines/index.js +19 -0
- package/dist/features/pipelines/list-pipelines/index.js.map +1 -0
- package/dist/features/pipelines/list-pipelines/schema.d.ts +9 -0
- package/dist/features/pipelines/list-pipelines/schema.js +23 -0
- package/dist/features/pipelines/list-pipelines/schema.js.map +1 -0
- package/dist/features/pipelines/pipeline-timeline/feature.d.ts +3 -0
- package/dist/features/pipelines/pipeline-timeline/feature.js +95 -0
- package/dist/features/pipelines/pipeline-timeline/feature.js.map +1 -0
- package/dist/features/pipelines/pipeline-timeline/index.d.ts +2 -0
- package/dist/features/pipelines/pipeline-timeline/index.js +19 -0
- package/dist/features/pipelines/pipeline-timeline/index.js.map +1 -0
- package/dist/features/pipelines/pipeline-timeline/schema.d.ts +31 -0
- package/dist/features/pipelines/pipeline-timeline/schema.js +51 -0
- package/dist/features/pipelines/pipeline-timeline/schema.js.map +1 -0
- package/dist/features/pipelines/tool-definitions.d.ts +5 -0
- package/dist/features/pipelines/tool-definitions.js +87 -0
- package/dist/features/pipelines/tool-definitions.js.map +1 -0
- package/dist/features/pipelines/trigger-pipeline/feature.d.ts +10 -0
- package/dist/features/pipelines/trigger-pipeline/feature.js +65 -0
- package/dist/features/pipelines/trigger-pipeline/feature.js.map +1 -0
- package/dist/features/pipelines/trigger-pipeline/index.d.ts +2 -0
- package/dist/features/pipelines/trigger-pipeline/index.js +8 -0
- package/dist/features/pipelines/trigger-pipeline/index.js.map +1 -0
- package/dist/features/pipelines/trigger-pipeline/schema.d.ts +15 -0
- package/dist/features/pipelines/trigger-pipeline/schema.js +45 -0
- package/dist/features/pipelines/trigger-pipeline/schema.js.map +1 -0
- package/dist/features/pipelines/types.d.ts +122 -0
- package/dist/features/pipelines/types.js +3 -0
- package/dist/features/pipelines/types.js.map +1 -0
- package/dist/features/projects/__test__/test-helpers.d.ts +13 -0
- package/dist/features/projects/__test__/test-helpers.js +35 -0
- package/dist/features/projects/__test__/test-helpers.js.map +1 -0
- package/dist/features/projects/get-project/feature.d.ts +11 -0
- package/dist/features/projects/get-project/feature.js +29 -0
- package/dist/features/projects/get-project/feature.js.map +1 -0
- package/dist/features/projects/get-project/index.d.ts +2 -0
- package/dist/features/projects/get-project/index.js +19 -0
- package/dist/features/projects/get-project/index.js.map +1 -0
- package/dist/features/projects/get-project/schema.d.ts +2 -0
- package/dist/features/projects/get-project/schema.js +6 -0
- package/dist/features/projects/get-project/schema.js.map +1 -0
- package/dist/features/projects/get-project-details/feature.d.ts +78 -0
- package/dist/features/projects/get-project-details/feature.js +185 -0
- package/dist/features/projects/get-project-details/feature.js.map +1 -0
- package/dist/features/projects/get-project-details/index.d.ts +2 -0
- package/dist/features/projects/get-project-details/index.js +8 -0
- package/dist/features/projects/get-project-details/index.js.map +1 -0
- package/dist/features/projects/get-project-details/schema.d.ts +2 -0
- package/dist/features/projects/get-project-details/schema.js +6 -0
- package/dist/features/projects/get-project-details/schema.js.map +1 -0
- package/dist/features/projects/index.d.ts +15 -0
- package/dist/features/projects/index.js +80 -0
- package/dist/features/projects/index.js.map +1 -0
- package/dist/features/projects/list-projects/feature.d.ts +10 -0
- package/dist/features/projects/list-projects/feature.js +25 -0
- package/dist/features/projects/list-projects/feature.js.map +1 -0
- package/dist/features/projects/list-projects/index.d.ts +2 -0
- package/dist/features/projects/list-projects/index.js +19 -0
- package/dist/features/projects/list-projects/index.js.map +1 -0
- package/dist/features/projects/list-projects/schema.d.ts +2 -0
- package/dist/features/projects/list-projects/schema.js +6 -0
- package/dist/features/projects/list-projects/schema.js.map +1 -0
- package/dist/features/projects/schemas.d.ts +30 -0
- package/dist/features/projects/schemas.js +76 -0
- package/dist/features/projects/schemas.js.map +1 -0
- package/dist/features/projects/tool-definitions.d.ts +5 -0
- package/dist/features/projects/tool-definitions.js +26 -0
- package/dist/features/projects/tool-definitions.js.map +1 -0
- package/dist/features/projects/types.d.ts +11 -0
- package/dist/features/projects/types.js +3 -0
- package/dist/features/projects/types.js.map +1 -0
- package/dist/features/pull-requests/add-pull-request-comment/feature.d.ts +13 -0
- package/dist/features/pull-requests/add-pull-request-comment/feature.js +161 -0
- package/dist/features/pull-requests/add-pull-request-comment/feature.js.map +1 -0
- package/dist/features/pull-requests/add-pull-request-comment/index.d.ts +1 -0
- package/dist/features/pull-requests/add-pull-request-comment/index.js +18 -0
- package/dist/features/pull-requests/add-pull-request-comment/index.js.map +1 -0
- package/dist/features/pull-requests/create-pull-request/feature.d.ts +12 -0
- package/dist/features/pull-requests/create-pull-request/feature.js +99 -0
- package/dist/features/pull-requests/create-pull-request/feature.js.map +1 -0
- package/dist/features/pull-requests/create-pull-request/index.d.ts +2 -0
- package/dist/features/pull-requests/create-pull-request/index.js +19 -0
- package/dist/features/pull-requests/create-pull-request/index.js.map +1 -0
- package/dist/features/pull-requests/create-pull-request/schema.d.ts +2 -0
- package/dist/features/pull-requests/create-pull-request/schema.js +6 -0
- package/dist/features/pull-requests/create-pull-request/schema.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request/feature.d.ts +6 -0
- package/dist/features/pull-requests/get-pull-request/feature.js +22 -0
- package/dist/features/pull-requests/get-pull-request/feature.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request/index.d.ts +2 -0
- package/dist/features/pull-requests/get-pull-request/index.js +19 -0
- package/dist/features/pull-requests/get-pull-request/index.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request/schema.d.ts +1 -0
- package/dist/features/pull-requests/get-pull-request/schema.js +6 -0
- package/dist/features/pull-requests/get-pull-request/schema.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-changes/feature.d.ts +22 -0
- package/dist/features/pull-requests/get-pull-request-changes/feature.js +60 -0
- package/dist/features/pull-requests/get-pull-request-changes/feature.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-changes/index.d.ts +1 -0
- package/dist/features/pull-requests/get-pull-request-changes/index.js +18 -0
- package/dist/features/pull-requests/get-pull-request-changes/index.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-checks/feature.d.ts +51 -0
- package/dist/features/pull-requests/get-pull-request-checks/feature.js +259 -0
- package/dist/features/pull-requests/get-pull-request-checks/feature.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-checks/index.d.ts +1 -0
- package/dist/features/pull-requests/get-pull-request-checks/index.js +18 -0
- package/dist/features/pull-requests/get-pull-request-checks/index.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-comments/feature.d.ts +13 -0
- package/dist/features/pull-requests/get-pull-request-comments/feature.js +88 -0
- package/dist/features/pull-requests/get-pull-request-comments/feature.js.map +1 -0
- package/dist/features/pull-requests/get-pull-request-comments/index.d.ts +1 -0
- package/dist/features/pull-requests/get-pull-request-comments/index.js +18 -0
- package/dist/features/pull-requests/get-pull-request-comments/index.js.map +1 -0
- package/dist/features/pull-requests/index.d.ts +21 -0
- package/dist/features/pull-requests/index.js +167 -0
- package/dist/features/pull-requests/index.js.map +1 -0
- package/dist/features/pull-requests/list-pull-requests/feature.d.ts +17 -0
- package/dist/features/pull-requests/list-pull-requests/feature.js +81 -0
- package/dist/features/pull-requests/list-pull-requests/feature.js.map +1 -0
- package/dist/features/pull-requests/list-pull-requests/index.d.ts +2 -0
- package/dist/features/pull-requests/list-pull-requests/index.js +19 -0
- package/dist/features/pull-requests/list-pull-requests/index.js.map +1 -0
- package/dist/features/pull-requests/list-pull-requests/schema.d.ts +1 -0
- package/dist/features/pull-requests/list-pull-requests/schema.js +6 -0
- package/dist/features/pull-requests/list-pull-requests/schema.js.map +1 -0
- package/dist/features/pull-requests/schemas.d.ts +157 -0
- package/dist/features/pull-requests/schemas.js +337 -0
- package/dist/features/pull-requests/schemas.js.map +1 -0
- package/dist/features/pull-requests/tool-definitions.d.ts +5 -0
- package/dist/features/pull-requests/tool-definitions.js +60 -0
- package/dist/features/pull-requests/tool-definitions.js.map +1 -0
- package/dist/features/pull-requests/types.d.ts +118 -0
- package/dist/features/pull-requests/types.js +3 -0
- package/dist/features/pull-requests/types.js.map +1 -0
- package/dist/features/pull-requests/update-pull-request/feature.d.ts +9 -0
- package/dist/features/pull-requests/update-pull-request/feature.js +250 -0
- package/dist/features/pull-requests/update-pull-request/feature.js.map +1 -0
- package/dist/features/pull-requests/update-pull-request/index.d.ts +1 -0
- package/dist/features/pull-requests/update-pull-request/index.js +18 -0
- package/dist/features/pull-requests/update-pull-request/index.js.map +1 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/feature.d.ts +14 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/feature.js +87 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/feature.js.map +1 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/index.d.ts +1 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/index.js +18 -0
- package/dist/features/pull-requests/update-pull-request-thread-status/index.js.map +1 -0
- package/dist/features/repositories/__test__/test-helpers.d.ts +13 -0
- package/dist/features/repositories/__test__/test-helpers.js +35 -0
- package/dist/features/repositories/__test__/test-helpers.js.map +1 -0
- package/dist/features/repositories/create-branch/feature.d.ts +6 -0
- package/dist/features/repositories/create-branch/feature.js +33 -0
- package/dist/features/repositories/create-branch/feature.js.map +1 -0
- package/dist/features/repositories/create-branch/index.d.ts +1 -0
- package/dist/features/repositories/create-branch/index.js +18 -0
- package/dist/features/repositories/create-branch/index.js.map +1 -0
- package/dist/features/repositories/create-commit/feature.d.ts +6 -0
- package/dist/features/repositories/create-commit/feature.js +122 -0
- package/dist/features/repositories/create-commit/feature.js.map +1 -0
- package/dist/features/repositories/create-commit/index.d.ts +1 -0
- package/dist/features/repositories/create-commit/index.js +18 -0
- package/dist/features/repositories/create-commit/index.js.map +1 -0
- package/dist/features/repositories/get-all-repositories-tree/feature.d.ts +22 -0
- package/dist/features/repositories/get-all-repositories-tree/feature.js +303 -0
- package/dist/features/repositories/get-all-repositories-tree/feature.js.map +1 -0
- package/dist/features/repositories/get-all-repositories-tree/index.d.ts +2 -0
- package/dist/features/repositories/get-all-repositories-tree/index.js +19 -0
- package/dist/features/repositories/get-all-repositories-tree/index.js.map +1 -0
- package/dist/features/repositories/get-all-repositories-tree/schema.d.ts +2 -0
- package/dist/features/repositories/get-all-repositories-tree/schema.js +6 -0
- package/dist/features/repositories/get-all-repositories-tree/schema.js.map +1 -0
- package/dist/features/repositories/get-file-content/feature.d.ts +23 -0
- package/dist/features/repositories/get-file-content/feature.js +96 -0
- package/dist/features/repositories/get-file-content/feature.js.map +1 -0
- package/dist/features/repositories/get-file-content/index.d.ts +2 -0
- package/dist/features/repositories/get-file-content/index.js +19 -0
- package/dist/features/repositories/get-file-content/index.js.map +1 -0
- package/dist/features/repositories/get-file-content/schema.d.ts +2 -0
- package/dist/features/repositories/get-file-content/schema.js +6 -0
- package/dist/features/repositories/get-file-content/schema.js.map +1 -0
- package/dist/features/repositories/get-repository/feature.d.ts +12 -0
- package/dist/features/repositories/get-repository/feature.js +30 -0
- package/dist/features/repositories/get-repository/feature.js.map +1 -0
- package/dist/features/repositories/get-repository/index.d.ts +2 -0
- package/dist/features/repositories/get-repository/index.js +19 -0
- package/dist/features/repositories/get-repository/index.js.map +1 -0
- package/dist/features/repositories/get-repository/schema.d.ts +2 -0
- package/dist/features/repositories/get-repository/schema.js +6 -0
- package/dist/features/repositories/get-repository/schema.js.map +1 -0
- package/dist/features/repositories/get-repository-details/feature.d.ts +11 -0
- package/dist/features/repositories/get-repository-details/feature.js +67 -0
- package/dist/features/repositories/get-repository-details/feature.js.map +1 -0
- package/dist/features/repositories/get-repository-details/index.d.ts +2 -0
- package/dist/features/repositories/get-repository-details/index.js +19 -0
- package/dist/features/repositories/get-repository-details/index.js.map +1 -0
- package/dist/features/repositories/get-repository-details/schema.d.ts +2 -0
- package/dist/features/repositories/get-repository-details/schema.js +6 -0
- package/dist/features/repositories/get-repository-details/schema.js.map +1 -0
- package/dist/features/repositories/get-repository-tree/feature.d.ts +6 -0
- package/dist/features/repositories/get-repository-tree/feature.js +65 -0
- package/dist/features/repositories/get-repository-tree/feature.js.map +1 -0
- package/dist/features/repositories/get-repository-tree/index.d.ts +1 -0
- package/dist/features/repositories/get-repository-tree/index.js +18 -0
- package/dist/features/repositories/get-repository-tree/index.js.map +1 -0
- package/dist/features/repositories/index.d.ts +23 -0
- package/dist/features/repositories/index.js +207 -0
- package/dist/features/repositories/index.js.map +1 -0
- package/dist/features/repositories/list-branches/feature.d.ts +14 -0
- package/dist/features/repositories/list-branches/feature.js +56 -0
- package/dist/features/repositories/list-branches/feature.js.map +1 -0
- package/dist/features/repositories/list-branches/index.d.ts +2 -0
- package/dist/features/repositories/list-branches/index.js +19 -0
- package/dist/features/repositories/list-branches/index.js.map +1 -0
- package/dist/features/repositories/list-branches/schema.d.ts +8 -0
- package/dist/features/repositories/list-branches/schema.js +28 -0
- package/dist/features/repositories/list-branches/schema.js.map +1 -0
- package/dist/features/repositories/list-commits/feature.d.ts +6 -0
- package/dist/features/repositories/list-commits/feature.js +75 -0
- package/dist/features/repositories/list-commits/feature.js.map +1 -0
- package/dist/features/repositories/list-commits/index.d.ts +1 -0
- package/dist/features/repositories/list-commits/index.js +18 -0
- package/dist/features/repositories/list-commits/index.js.map +1 -0
- package/dist/features/repositories/list-repositories/feature.d.ts +10 -0
- package/dist/features/repositories/list-repositories/feature.js +25 -0
- package/dist/features/repositories/list-repositories/feature.js.map +1 -0
- package/dist/features/repositories/list-repositories/index.d.ts +2 -0
- package/dist/features/repositories/list-repositories/index.js +19 -0
- package/dist/features/repositories/list-repositories/index.js.map +1 -0
- package/dist/features/repositories/list-repositories/schema.d.ts +2 -0
- package/dist/features/repositories/list-repositories/schema.js +6 -0
- package/dist/features/repositories/list-repositories/schema.js.map +1 -0
- package/dist/features/repositories/list-tags/feature.d.ts +13 -0
- package/dist/features/repositories/list-tags/feature.js +52 -0
- package/dist/features/repositories/list-tags/feature.js.map +1 -0
- package/dist/features/repositories/list-tags/index.d.ts +2 -0
- package/dist/features/repositories/list-tags/index.js +19 -0
- package/dist/features/repositories/list-tags/index.js.map +1 -0
- package/dist/features/repositories/list-tags/schema.d.ts +8 -0
- package/dist/features/repositories/list-tags/schema.js +28 -0
- package/dist/features/repositories/list-tags/schema.js.map +1 -0
- package/dist/features/repositories/schemas.d.ts +101 -0
- package/dist/features/repositories/schemas.js +306 -0
- package/dist/features/repositories/schemas.js.map +1 -0
- package/dist/features/repositories/tool-definitions.d.ts +5 -0
- package/dist/features/repositories/tool-definitions.js +106 -0
- package/dist/features/repositories/tool-definitions.js.map +1 -0
- package/dist/features/repositories/types.d.ts +167 -0
- package/dist/features/repositories/types.js +3 -0
- package/dist/features/repositories/types.js.map +1 -0
- package/dist/features/search/index.d.ts +15 -0
- package/dist/features/search/index.js +65 -0
- package/dist/features/search/index.js.map +1 -0
- package/dist/features/search/schemas.d.ts +58 -0
- package/dist/features/search/schemas.js +159 -0
- package/dist/features/search/schemas.js.map +1 -0
- package/dist/features/search/search-code/feature.d.ts +10 -0
- package/dist/features/search/search-code/feature.js +178 -0
- package/dist/features/search/search-code/feature.js.map +1 -0
- package/dist/features/search/search-code/index.d.ts +2 -0
- package/dist/features/search/search-code/index.js +19 -0
- package/dist/features/search/search-code/index.js.map +1 -0
- package/dist/features/search/search-wiki/feature.d.ts +10 -0
- package/dist/features/search/search-wiki/feature.js +133 -0
- package/dist/features/search/search-wiki/feature.js.map +1 -0
- package/dist/features/search/search-wiki/index.d.ts +1 -0
- package/dist/features/search/search-wiki/index.js +18 -0
- package/dist/features/search/search-wiki/index.js.map +1 -0
- package/dist/features/search/search-work-items/feature.d.ts +10 -0
- package/dist/features/search/search-work-items/feature.js +119 -0
- package/dist/features/search/search-work-items/feature.js.map +1 -0
- package/dist/features/search/search-work-items/index.d.ts +1 -0
- package/dist/features/search/search-work-items/index.js +18 -0
- package/dist/features/search/search-work-items/index.js.map +1 -0
- package/dist/features/search/tool-definitions.d.ts +5 -0
- package/dist/features/search/tool-definitions.js +26 -0
- package/dist/features/search/tool-definitions.js.map +1 -0
- package/dist/features/search/types.d.ts +537 -0
- package/dist/features/search/types.js +3 -0
- package/dist/features/search/types.js.map +1 -0
- package/dist/features/service-connections/feature.d.ts +21 -0
- package/dist/features/service-connections/feature.js +51 -0
- package/dist/features/service-connections/feature.js.map +1 -0
- package/dist/features/service-connections/index.d.ts +10 -0
- package/dist/features/service-connections/index.js +42 -0
- package/dist/features/service-connections/index.js.map +1 -0
- package/dist/features/service-connections/schema.d.ts +8 -0
- package/dist/features/service-connections/schema.js +28 -0
- package/dist/features/service-connections/schema.js.map +1 -0
- package/dist/features/users/get-me/feature.d.ts +12 -0
- package/dist/features/users/get-me/feature.js +96 -0
- package/dist/features/users/get-me/feature.js.map +1 -0
- package/dist/features/users/get-me/index.d.ts +2 -0
- package/dist/features/users/get-me/index.js +19 -0
- package/dist/features/users/get-me/index.js.map +1 -0
- package/dist/features/users/get-me/schema.d.ts +2 -0
- package/dist/features/users/get-me/schema.js +6 -0
- package/dist/features/users/get-me/schema.js.map +1 -0
- package/dist/features/users/index.d.ts +17 -0
- package/dist/features/users/index.js +52 -0
- package/dist/features/users/index.js.map +1 -0
- package/dist/features/users/schemas.d.ts +5 -0
- package/dist/features/users/schemas.js +9 -0
- package/dist/features/users/schemas.js.map +1 -0
- package/dist/features/users/tool-definitions.d.ts +5 -0
- package/dist/features/users/tool-definitions.js +16 -0
- package/dist/features/users/tool-definitions.js.map +1 -0
- package/dist/features/users/types.d.ts +17 -0
- package/dist/features/users/types.js +3 -0
- package/dist/features/users/types.js.map +1 -0
- package/dist/features/wikis/create-wiki/feature.d.ts +49 -0
- package/dist/features/wikis/create-wiki/feature.js +56 -0
- package/dist/features/wikis/create-wiki/feature.js.map +1 -0
- package/dist/features/wikis/create-wiki/index.d.ts +2 -0
- package/dist/features/wikis/create-wiki/index.js +9 -0
- package/dist/features/wikis/create-wiki/index.js.map +1 -0
- package/dist/features/wikis/create-wiki/schema.d.ts +25 -0
- package/dist/features/wikis/create-wiki/schema.js +60 -0
- package/dist/features/wikis/create-wiki/schema.js.map +1 -0
- package/dist/features/wikis/create-wiki-page/feature.d.ts +18 -0
- package/dist/features/wikis/create-wiki-page/feature.js +95 -0
- package/dist/features/wikis/create-wiki-page/feature.js.map +1 -0
- package/dist/features/wikis/create-wiki-page/index.d.ts +2 -0
- package/dist/features/wikis/create-wiki-page/index.js +8 -0
- package/dist/features/wikis/create-wiki-page/index.js.map +1 -0
- package/dist/features/wikis/create-wiki-page/schema.d.ts +12 -0
- package/dist/features/wikis/create-wiki-page/schema.js +36 -0
- package/dist/features/wikis/create-wiki-page/schema.js.map +1 -0
- package/dist/features/wikis/get-wiki-page/feature.d.ts +33 -0
- package/dist/features/wikis/get-wiki-page/feature.js +68 -0
- package/dist/features/wikis/get-wiki-page/feature.js.map +1 -0
- package/dist/features/wikis/get-wiki-page/index.d.ts +2 -0
- package/dist/features/wikis/get-wiki-page/index.js +8 -0
- package/dist/features/wikis/get-wiki-page/index.js.map +1 -0
- package/dist/features/wikis/get-wiki-page/schema.d.ts +10 -0
- package/dist/features/wikis/get-wiki-page/schema.js +23 -0
- package/dist/features/wikis/get-wiki-page/schema.js.map +1 -0
- package/dist/features/wikis/get-wikis/feature.d.ts +25 -0
- package/dist/features/wikis/get-wikis/feature.js +37 -0
- package/dist/features/wikis/get-wikis/feature.js.map +1 -0
- package/dist/features/wikis/get-wikis/index.d.ts +2 -0
- package/dist/features/wikis/get-wikis/index.js +8 -0
- package/dist/features/wikis/get-wikis/index.js.map +1 -0
- package/dist/features/wikis/get-wikis/schema.d.ts +8 -0
- package/dist/features/wikis/get-wikis/schema.js +21 -0
- package/dist/features/wikis/get-wikis/schema.js.map +1 -0
- package/dist/features/wikis/index.d.ts +16 -0
- package/dist/features/wikis/index.js +141 -0
- package/dist/features/wikis/index.js.map +1 -0
- package/dist/features/wikis/list-wiki-pages/feature.d.ts +20 -0
- package/dist/features/wikis/list-wiki-pages/feature.js +79 -0
- package/dist/features/wikis/list-wiki-pages/feature.js.map +1 -0
- package/dist/features/wikis/list-wiki-pages/index.d.ts +2 -0
- package/dist/features/wikis/list-wiki-pages/index.js +8 -0
- package/dist/features/wikis/list-wiki-pages/index.js.map +1 -0
- package/dist/features/wikis/list-wiki-pages/schema.d.ts +10 -0
- package/dist/features/wikis/list-wiki-pages/schema.js +22 -0
- package/dist/features/wikis/list-wiki-pages/schema.js.map +1 -0
- package/dist/features/wikis/tool-definitions.d.ts +5 -0
- package/dist/features/wikis/tool-definitions.js +46 -0
- package/dist/features/wikis/tool-definitions.js.map +1 -0
- package/dist/features/wikis/update-wiki-page/feature.d.ts +12 -0
- package/dist/features/wikis/update-wiki-page/feature.js +63 -0
- package/dist/features/wikis/update-wiki-page/feature.js.map +1 -0
- package/dist/features/wikis/update-wiki-page/index.d.ts +2 -0
- package/dist/features/wikis/update-wiki-page/index.js +8 -0
- package/dist/features/wikis/update-wiki-page/index.js.map +1 -0
- package/dist/features/wikis/update-wiki-page/schema.d.ts +12 -0
- package/dist/features/wikis/update-wiki-page/schema.js +32 -0
- package/dist/features/wikis/update-wiki-page/schema.js.map +1 -0
- package/dist/features/work-items/__test__/fixtures.d.ts +9 -0
- package/dist/features/work-items/__test__/fixtures.js +28 -0
- package/dist/features/work-items/__test__/fixtures.js.map +1 -0
- package/dist/features/work-items/__test__/test-helpers.d.ts +13 -0
- package/dist/features/work-items/__test__/test-helpers.js +35 -0
- package/dist/features/work-items/__test__/test-helpers.js.map +1 -0
- package/dist/features/work-items/__test__/test-utils.d.ts +17 -0
- package/dist/features/work-items/__test__/test-utils.js +39 -0
- package/dist/features/work-items/__test__/test-utils.js.map +1 -0
- package/dist/features/work-items/attachment-schemas.d.ts +24 -0
- package/dist/features/work-items/attachment-schemas.js +46 -0
- package/dist/features/work-items/attachment-schemas.js.map +1 -0
- package/dist/features/work-items/create-work-item/feature.d.ts +12 -0
- package/dist/features/work-items/create-work-item/feature.js +107 -0
- package/dist/features/work-items/create-work-item/feature.js.map +1 -0
- package/dist/features/work-items/create-work-item/index.d.ts +2 -0
- package/dist/features/work-items/create-work-item/index.js +19 -0
- package/dist/features/work-items/create-work-item/index.js.map +1 -0
- package/dist/features/work-items/create-work-item/schema.d.ts +2 -0
- package/dist/features/work-items/create-work-item/schema.js +6 -0
- package/dist/features/work-items/create-work-item/schema.js.map +1 -0
- package/dist/features/work-items/create-work-item-attachment/feature.d.ts +11 -0
- package/dist/features/work-items/create-work-item-attachment/feature.js +107 -0
- package/dist/features/work-items/create-work-item-attachment/feature.js.map +1 -0
- package/dist/features/work-items/create-work-item-attachment/index.d.ts +2 -0
- package/dist/features/work-items/create-work-item-attachment/index.js +19 -0
- package/dist/features/work-items/create-work-item-attachment/index.js.map +1 -0
- package/dist/features/work-items/create-work-item-attachment/schema.d.ts +2 -0
- package/dist/features/work-items/create-work-item-attachment/schema.js +6 -0
- package/dist/features/work-items/create-work-item-attachment/schema.js.map +1 -0
- package/dist/features/work-items/delete-work-item-attachment/feature.d.ts +10 -0
- package/dist/features/work-items/delete-work-item-attachment/feature.js +51 -0
- package/dist/features/work-items/delete-work-item-attachment/feature.js.map +1 -0
- package/dist/features/work-items/delete-work-item-attachment/index.d.ts +2 -0
- package/dist/features/work-items/delete-work-item-attachment/index.js +19 -0
- package/dist/features/work-items/delete-work-item-attachment/index.js.map +1 -0
- package/dist/features/work-items/delete-work-item-attachment/schema.d.ts +2 -0
- package/dist/features/work-items/delete-work-item-attachment/schema.js +6 -0
- package/dist/features/work-items/delete-work-item-attachment/schema.js.map +1 -0
- package/dist/features/work-items/get-work-item/feature.d.ts +12 -0
- package/dist/features/work-items/get-work-item/feature.js +69 -0
- package/dist/features/work-items/get-work-item/feature.js.map +1 -0
- package/dist/features/work-items/get-work-item/index.d.ts +2 -0
- package/dist/features/work-items/get-work-item/index.js +19 -0
- package/dist/features/work-items/get-work-item/index.js.map +1 -0
- package/dist/features/work-items/get-work-item/schema.d.ts +2 -0
- package/dist/features/work-items/get-work-item/schema.js +6 -0
- package/dist/features/work-items/get-work-item/schema.js.map +1 -0
- package/dist/features/work-items/get-work-item-attachment/feature.d.ts +10 -0
- package/dist/features/work-items/get-work-item-attachment/feature.js +108 -0
- package/dist/features/work-items/get-work-item-attachment/feature.js.map +1 -0
- package/dist/features/work-items/get-work-item-attachment/index.d.ts +2 -0
- package/dist/features/work-items/get-work-item-attachment/index.js +19 -0
- package/dist/features/work-items/get-work-item-attachment/index.js.map +1 -0
- package/dist/features/work-items/get-work-item-attachment/schema.d.ts +2 -0
- package/dist/features/work-items/get-work-item-attachment/schema.js +6 -0
- package/dist/features/work-items/get-work-item-attachment/schema.js.map +1 -0
- package/dist/features/work-items/get-work-item-comments/feature.d.ts +10 -0
- package/dist/features/work-items/get-work-item-comments/feature.js +78 -0
- package/dist/features/work-items/get-work-item-comments/feature.js.map +1 -0
- package/dist/features/work-items/get-work-item-comments/index.d.ts +2 -0
- package/dist/features/work-items/get-work-item-comments/index.js +19 -0
- package/dist/features/work-items/get-work-item-comments/index.js.map +1 -0
- package/dist/features/work-items/get-work-item-comments/schema.d.ts +2 -0
- package/dist/features/work-items/get-work-item-comments/schema.js +6 -0
- package/dist/features/work-items/get-work-item-comments/schema.js.map +1 -0
- package/dist/features/work-items/index.d.ts +21 -0
- package/dist/features/work-items/index.js +181 -0
- package/dist/features/work-items/index.js.map +1 -0
- package/dist/features/work-items/list-work-items/feature.d.ts +10 -0
- package/dist/features/work-items/list-work-items/feature.js +92 -0
- package/dist/features/work-items/list-work-items/feature.js.map +1 -0
- package/dist/features/work-items/list-work-items/index.d.ts +2 -0
- package/dist/features/work-items/list-work-items/index.js +19 -0
- package/dist/features/work-items/list-work-items/index.js.map +1 -0
- package/dist/features/work-items/list-work-items/schema.d.ts +2 -0
- package/dist/features/work-items/list-work-items/schema.js +6 -0
- package/dist/features/work-items/list-work-items/schema.js.map +1 -0
- package/dist/features/work-items/manage-work-item-link/feature.d.ts +24 -0
- package/dist/features/work-items/manage-work-item-link/feature.js +91 -0
- package/dist/features/work-items/manage-work-item-link/feature.js.map +1 -0
- package/dist/features/work-items/manage-work-item-link/index.d.ts +2 -0
- package/dist/features/work-items/manage-work-item-link/index.js +8 -0
- package/dist/features/work-items/manage-work-item-link/index.js.map +1 -0
- package/dist/features/work-items/manage-work-item-link/schema.d.ts +2 -0
- package/dist/features/work-items/manage-work-item-link/schema.js +6 -0
- package/dist/features/work-items/manage-work-item-link/schema.js.map +1 -0
- package/dist/features/work-items/schemas.d.ts +99 -0
- package/dist/features/work-items/schemas.js +181 -0
- package/dist/features/work-items/schemas.js.map +1 -0
- package/dist/features/work-items/tool-definitions.d.ts +5 -0
- package/dist/features/work-items/tool-definitions.js +56 -0
- package/dist/features/work-items/tool-definitions.js.map +1 -0
- package/dist/features/work-items/types.d.ts +87 -0
- package/dist/features/work-items/types.js +3 -0
- package/dist/features/work-items/types.js.map +1 -0
- package/dist/features/work-items/update-work-item/feature.d.ts +12 -0
- package/dist/features/work-items/update-work-item/feature.js +155 -0
- package/dist/features/work-items/update-work-item/feature.js.map +1 -0
- package/dist/features/work-items/update-work-item/index.d.ts +2 -0
- package/dist/features/work-items/update-work-item/index.js +19 -0
- package/dist/features/work-items/update-work-item/index.js.map +1 -0
- package/dist/features/work-items/update-work-item/schema.d.ts +2 -0
- package/dist/features/work-items/update-work-item/schema.js +6 -0
- package/dist/features/work-items/update-work-item/schema.js.map +1 -0
- package/dist/http-server.d.ts +22 -0
- package/dist/http-server.js +137 -0
- package/dist/http-server.js.map +1 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.js +138 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +21 -0
- package/dist/server.js +379 -0
- package/dist/server.js.map +1 -0
- package/dist/shared/api/client.d.ts +91 -0
- package/dist/shared/api/client.js +242 -0
- package/dist/shared/api/client.js.map +1 -0
- package/dist/shared/api/index.d.ts +1 -0
- package/dist/shared/api/index.js +18 -0
- package/dist/shared/api/index.js.map +1 -0
- package/dist/shared/auth/auth-factory.d.ts +53 -0
- package/dist/shared/auth/auth-factory.js +194 -0
- package/dist/shared/auth/auth-factory.js.map +1 -0
- package/dist/shared/auth/client-factory.d.ts +109 -0
- package/dist/shared/auth/client-factory.js +272 -0
- package/dist/shared/auth/client-factory.js.map +1 -0
- package/dist/shared/auth/index.d.ts +11 -0
- package/dist/shared/auth/index.js +18 -0
- package/dist/shared/auth/index.js.map +1 -0
- package/dist/shared/azure-devops-url.d.ts +17 -0
- package/dist/shared/azure-devops-url.js +120 -0
- package/dist/shared/azure-devops-url.js.map +1 -0
- package/dist/shared/config/index.d.ts +1 -0
- package/dist/shared/config/index.js +18 -0
- package/dist/shared/config/index.js.map +1 -0
- package/dist/shared/config/version.d.ts +4 -0
- package/dist/shared/config/version.js +8 -0
- package/dist/shared/config/version.js.map +1 -0
- package/dist/shared/enums/index.d.ts +40 -0
- package/dist/shared/enums/index.js +87 -0
- package/dist/shared/enums/index.js.map +1 -0
- package/dist/shared/errors/azure-devops-errors.d.ts +107 -0
- package/dist/shared/errors/azure-devops-errors.js +161 -0
- package/dist/shared/errors/azure-devops-errors.js.map +1 -0
- package/dist/shared/errors/handle-request-error.d.ts +32 -0
- package/dist/shared/errors/handle-request-error.js +121 -0
- package/dist/shared/errors/handle-request-error.js.map +1 -0
- package/dist/shared/errors/index.d.ts +1 -0
- package/dist/shared/errors/index.js +18 -0
- package/dist/shared/errors/index.js.map +1 -0
- package/dist/shared/test/test-helpers.d.ts +20 -0
- package/dist/shared/test/test-helpers.js +57 -0
- package/dist/shared/test/test-helpers.js.map +1 -0
- package/dist/shared/test/text-content.d.ts +10 -0
- package/dist/shared/test/text-content.js +20 -0
- package/dist/shared/test/text-content.js.map +1 -0
- package/dist/shared/types/config.d.ts +27 -0
- package/dist/shared/types/config.js +3 -0
- package/dist/shared/types/config.js.map +1 -0
- package/dist/shared/types/index.d.ts +1 -0
- package/dist/shared/types/index.js +18 -0
- package/dist/shared/types/index.js.map +1 -0
- package/dist/shared/types/request-handler.d.ts +21 -0
- package/dist/shared/types/request-handler.js +3 -0
- package/dist/shared/types/request-handler.js.map +1 -0
- package/dist/shared/types/tool-definition.d.ts +9 -0
- package/dist/shared/types/tool-definition.js +3 -0
- package/dist/shared/types/tool-definition.js.map +1 -0
- package/dist/shared/utils/to-json-schema.d.ts +6 -0
- package/dist/shared/utils/to-json-schema.js +12 -0
- package/dist/shared/utils/to-json-schema.js.map +1 -0
- package/dist/utils/environment.d.ts +21 -0
- package/dist/utils/environment.js +58 -0
- package/dist/utils/environment.js.map +1 -0
- package/docs/SOLUTION_SUMMARY.md +145 -0
- package/docs/authentication.md +293 -0
- package/docs/azure-identity-authentication.md +187 -0
- package/docs/ci-setup.md +61 -0
- package/docs/docker.md +135 -0
- package/docs/examples/README.md +33 -0
- package/docs/examples/azure-cli-authentication.env +25 -0
- package/docs/examples/azure-identity-authentication.env +33 -0
- package/docs/examples/pat-authentication.env +24 -0
- package/docs/important-knowledge/azure-devops-rest-api-research.md +88 -0
- package/docs/important-knowledge/llm-tldr-cli.md +37 -0
- package/docs/npm-trusted-publishers-migration.md +142 -0
- package/docs/release-troubleshooting.md +153 -0
- package/docs/testing/README.md +140 -0
- package/docs/testing/setup.md +72 -0
- package/docs/tools/README.md +76 -0
- package/docs/tools/core-navigation.md +114 -0
- package/docs/tools/organizations.md +73 -0
- package/docs/tools/pipelines.md +532 -0
- package/docs/tools/projects.md +114 -0
- package/docs/tools/pull-requests.md +1110 -0
- package/docs/tools/repositories.md +610 -0
- package/docs/tools/resources.md +133 -0
- package/docs/tools/search.md +165 -0
- package/docs/tools/user-tools.md +39 -0
- package/docs/tools/wiki.md +192 -0
- package/docs/tools/work-items.md +244 -0
- package/package.json +125 -4
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
# Azure Identity Authentication for Azure DevOps MCP Server
|
|
2
|
+
|
|
3
|
+
This guide explains how to use Azure Identity authentication with the Azure DevOps MCP Server.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Azure Identity authentication lets you use your existing Azure credentials to authenticate with Azure DevOps, instead of creating and managing Personal Access Tokens (PATs). This approach offers several benefits:
|
|
8
|
+
|
|
9
|
+
- **Unified authentication**: Use the same credentials for Azure and Azure DevOps
|
|
10
|
+
- **Enhanced security**: Support for managed identities and client certificates
|
|
11
|
+
- **Flexible credential types**: Multiple options for different environments
|
|
12
|
+
- **Automatic token management**: Handles token acquisition and renewal
|
|
13
|
+
|
|
14
|
+
## Credential Types
|
|
15
|
+
|
|
16
|
+
The Azure DevOps MCP Server supports multiple credential types through the Azure Identity SDK:
|
|
17
|
+
|
|
18
|
+
### DefaultAzureCredential
|
|
19
|
+
|
|
20
|
+
This credential type attempts multiple authentication methods in sequence until one succeeds:
|
|
21
|
+
|
|
22
|
+
1. Environment variables (EnvironmentCredential)
|
|
23
|
+
2. Managed Identity (ManagedIdentityCredential)
|
|
24
|
+
3. Azure CLI (AzureCliCredential)
|
|
25
|
+
4. Visual Studio Code (VisualStudioCodeCredential)
|
|
26
|
+
5. Azure PowerShell (AzurePowerShellCredential)
|
|
27
|
+
|
|
28
|
+
It's a great option for applications that need to work across different environments without code changes.
|
|
29
|
+
|
|
30
|
+
### AzureCliCredential
|
|
31
|
+
|
|
32
|
+
This credential type uses your Azure CLI login. It's perfect for local development when you're already using the Azure CLI.
|
|
33
|
+
|
|
34
|
+
## Configuration
|
|
35
|
+
|
|
36
|
+
### Environment Variables
|
|
37
|
+
|
|
38
|
+
To use Azure Identity authentication, set the following environment variables:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# Required
|
|
42
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
43
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
44
|
+
|
|
45
|
+
# Optional
|
|
46
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=your-project-name
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
For service principal authentication, add these environment variables:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
AZURE_TENANT_ID=your-tenant-id
|
|
53
|
+
AZURE_CLIENT_ID=your-client-id
|
|
54
|
+
AZURE_CLIENT_SECRET=your-client-secret
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Use with Claude Desktop/Cursor AI
|
|
58
|
+
|
|
59
|
+
Add the following to your configuration file:
|
|
60
|
+
|
|
61
|
+
```json
|
|
62
|
+
{
|
|
63
|
+
"mcpServers": {
|
|
64
|
+
"azureDevOps": {
|
|
65
|
+
"command": "npx",
|
|
66
|
+
"args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
|
|
67
|
+
"env": {
|
|
68
|
+
"AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
|
|
69
|
+
"AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
|
|
70
|
+
"AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Authentication Methods
|
|
78
|
+
|
|
79
|
+
### Method 1: Using Azure CLI
|
|
80
|
+
|
|
81
|
+
1. Install the Azure CLI from [here](https://docs.microsoft.com/cli/azure/install-azure-cli)
|
|
82
|
+
2. Log in to Azure:
|
|
83
|
+
```bash
|
|
84
|
+
az login
|
|
85
|
+
```
|
|
86
|
+
3. Set up your environment variables:
|
|
87
|
+
```bash
|
|
88
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
89
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Method 2: Using Service Principal
|
|
93
|
+
|
|
94
|
+
1. Create a service principal in Azure AD:
|
|
95
|
+
```bash
|
|
96
|
+
az ad sp create-for-rbac --name "MyAzureDevOpsApp"
|
|
97
|
+
```
|
|
98
|
+
2. Grant the service principal access to your Azure DevOps organization
|
|
99
|
+
3. Set up your environment variables:
|
|
100
|
+
```bash
|
|
101
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
102
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
103
|
+
AZURE_TENANT_ID=your-tenant-id
|
|
104
|
+
AZURE_CLIENT_ID=your-client-id
|
|
105
|
+
AZURE_CLIENT_SECRET=your-client-secret
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Method 3: Using Managed Identity (for Azure-hosted applications)
|
|
109
|
+
|
|
110
|
+
1. Enable managed identity for your Azure resource (VM, App Service, etc.)
|
|
111
|
+
2. Grant the managed identity access to your Azure DevOps organization
|
|
112
|
+
3. Set up your environment variables:
|
|
113
|
+
```bash
|
|
114
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
115
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Troubleshooting
|
|
119
|
+
|
|
120
|
+
### Common Issues
|
|
121
|
+
|
|
122
|
+
#### Failed to acquire token
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
Error: Failed to authenticate with Azure Identity: CredentialUnavailableError: DefaultAzureCredential failed to retrieve a token
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
**Possible solutions:**
|
|
129
|
+
- Ensure you're logged in with `az login`
|
|
130
|
+
- Check if your managed identity is correctly configured
|
|
131
|
+
- Verify that service principal credentials are correct
|
|
132
|
+
|
|
133
|
+
#### Permission issues
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
Error: Failed to authenticate with Azure Identity: AuthorizationFailed: The client does not have authorization to perform action
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
**Possible solutions:**
|
|
140
|
+
- Ensure your identity has the necessary permissions in Azure DevOps
|
|
141
|
+
- Check if you need to add your identity to specific Azure DevOps project(s)
|
|
142
|
+
|
|
143
|
+
#### Network issues
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
Error: Failed to authenticate with Azure Identity: ClientAuthError: Interaction required
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
**Possible solutions:**
|
|
150
|
+
- Check your network connectivity
|
|
151
|
+
- Verify that your firewall allows connections to Azure services
|
|
152
|
+
|
|
153
|
+
## Best Practices
|
|
154
|
+
|
|
155
|
+
1. **Choose the right credential type for your environment**:
|
|
156
|
+
- For local development: Azure CLI credential
|
|
157
|
+
- For CI/CD pipelines: Service principal
|
|
158
|
+
- For Azure-hosted applications: Managed identity
|
|
159
|
+
|
|
160
|
+
2. **Follow the principle of least privilege**:
|
|
161
|
+
- Only grant the permissions needed for your use case
|
|
162
|
+
- Regularly audit and review permissions
|
|
163
|
+
|
|
164
|
+
3. **Rotate credentials regularly**:
|
|
165
|
+
- For service principals, rotate client secrets periodically
|
|
166
|
+
- Use certificate-based authentication when possible for enhanced security
|
|
167
|
+
|
|
168
|
+
## Examples
|
|
169
|
+
|
|
170
|
+
### Basic configuration with Azure CLI
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/mycompany
|
|
174
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
175
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=MyProject
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### Service principal authentication
|
|
179
|
+
|
|
180
|
+
```bash
|
|
181
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/mycompany
|
|
182
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
183
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=MyProject
|
|
184
|
+
AZURE_TENANT_ID=00000000-0000-0000-0000-000000000000
|
|
185
|
+
AZURE_CLIENT_ID=11111111-1111-1111-1111-111111111111
|
|
186
|
+
AZURE_CLIENT_SECRET=your-client-secret
|
|
187
|
+
```
|
package/docs/ci-setup.md
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# CI Environment Setup for Integration Tests
|
|
2
|
+
|
|
3
|
+
This document explains how to set up the CI environment to run integration tests with Azure DevOps.
|
|
4
|
+
|
|
5
|
+
## GitHub Secrets Configuration
|
|
6
|
+
|
|
7
|
+
To run integration tests in the CI environment, you need to configure the following GitHub Secrets:
|
|
8
|
+
|
|
9
|
+
1. **AZURE_DEVOPS_ORG_URL**: The URL of your Azure DevOps organization (e.g., `https://dev.azure.com/your-organization`)
|
|
10
|
+
2. **AZURE_DEVOPS_PAT**: A Personal Access Token with appropriate permissions
|
|
11
|
+
3. **AZURE_DEVOPS_DEFAULT_PROJECT** (optional): The default project to use for tests
|
|
12
|
+
|
|
13
|
+
### Setting up GitHub Secrets
|
|
14
|
+
|
|
15
|
+
1. Go to your GitHub repository
|
|
16
|
+
2. Click on "Settings" > "Secrets and variables" > "Actions"
|
|
17
|
+
3. Click on "New repository secret"
|
|
18
|
+
4. Add each of the required secrets:
|
|
19
|
+
|
|
20
|
+
#### AZURE_DEVOPS_ORG_URL
|
|
21
|
+
|
|
22
|
+
- Name: `AZURE_DEVOPS_ORG_URL`
|
|
23
|
+
- Value: `https://dev.azure.com/your-organization`
|
|
24
|
+
|
|
25
|
+
#### AZURE_DEVOPS_PAT
|
|
26
|
+
|
|
27
|
+
- Name: `AZURE_DEVOPS_PAT`
|
|
28
|
+
- Value: Your Personal Access Token
|
|
29
|
+
|
|
30
|
+
#### AZURE_DEVOPS_DEFAULT_PROJECT (optional)
|
|
31
|
+
|
|
32
|
+
- Name: `AZURE_DEVOPS_DEFAULT_PROJECT`
|
|
33
|
+
- Value: Your project name
|
|
34
|
+
|
|
35
|
+
## Personal Access Token (PAT) Requirements
|
|
36
|
+
|
|
37
|
+
The PAT used for integration tests should have the following permissions:
|
|
38
|
+
|
|
39
|
+
- **Code**: Read & Write
|
|
40
|
+
- **Work Items**: Read & Write
|
|
41
|
+
- **Build**: Read & Execute
|
|
42
|
+
- **Project and Team**: Read
|
|
43
|
+
- **Graph**: Read
|
|
44
|
+
- **Release**: Read & Execute
|
|
45
|
+
|
|
46
|
+
## Security Considerations
|
|
47
|
+
|
|
48
|
+
- Use a dedicated Azure DevOps organization or project for testing
|
|
49
|
+
- Create a PAT with the minimum required permissions
|
|
50
|
+
- Consider setting an expiration date for the PAT
|
|
51
|
+
- Regularly rotate the PAT used in GitHub Secrets
|
|
52
|
+
|
|
53
|
+
## Troubleshooting
|
|
54
|
+
|
|
55
|
+
If integration tests fail in CI:
|
|
56
|
+
|
|
57
|
+
1. Check the GitHub Actions logs for detailed error messages
|
|
58
|
+
2. Verify that the PAT has not expired
|
|
59
|
+
3. Ensure the PAT has the required permissions
|
|
60
|
+
4. Confirm that the organization URL is correct
|
|
61
|
+
5. Check if the default project exists and is accessible with the provided PAT
|
package/docs/docker.md
ADDED
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# Running with Docker
|
|
2
|
+
|
|
3
|
+
The server ships with a `Dockerfile` that exposes the MCP protocol over **Streamable-HTTP** (`POST /mcp`), so you can test it with raw JSON-RPC from any HTTP client.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
docker run -d --name mcp-ado -p 8888:3000 \
|
|
11
|
+
-e AZURE_DEVOPS_ORG_URL="https://dev.azure.com/my-org" \
|
|
12
|
+
-e AZURE_DEVOPS_AUTH_METHOD=pat \
|
|
13
|
+
-e AZURE_DEVOPS_PAT="<your-pat>" \
|
|
14
|
+
-e AZURE_DEVOPS_DEFAULT_PROJECT="MyProject" \
|
|
15
|
+
aqajooon/mcp-server-azure-devops:latest
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
curl http://localhost:8888/healthz
|
|
20
|
+
# {"status":"ok"}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Docker Hub
|
|
26
|
+
|
|
27
|
+
Images are published automatically on every push to `main`:
|
|
28
|
+
|
|
29
|
+
| Tag | Description |
|
|
30
|
+
|-----|-------------|
|
|
31
|
+
| `latest` | Most recent main-branch build |
|
|
32
|
+
| `<full-git-sha>` | Exact commit build |
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
docker pull aqajooon/mcp-server-azure-devops:latest
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Build locally
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
docker build -t mcp-server-azure-devops:local .
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## Environment variables
|
|
49
|
+
|
|
50
|
+
| Variable | Required | Default | Description |
|
|
51
|
+
|---|---|---|---|
|
|
52
|
+
| `AZURE_DEVOPS_ORG_URL` | Yes | — | Organization or collection URL. On-prem: `https://host/tfs/Collection` — do **not** include the project |
|
|
53
|
+
| `AZURE_DEVOPS_AUTH_METHOD` | No | `pat` | `pat`, `azure-identity`, or `azure-cli` |
|
|
54
|
+
| `AZURE_DEVOPS_PAT` | Yes (if `pat`) | — | Personal Access Token |
|
|
55
|
+
| `AZURE_DEVOPS_DEFAULT_PROJECT` | No | — | Default project when tool calls omit `projectId` |
|
|
56
|
+
| `AZURE_DEVOPS_API_VERSION` | No | `7.1` | REST API version (e.g. `7.0` for ADO Server 2022) |
|
|
57
|
+
| `PORT` | No | `3000` | HTTP port inside the container |
|
|
58
|
+
| `MCP_PATH` | No | `/mcp` | URL path for the MCP endpoint |
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Docker Compose
|
|
63
|
+
|
|
64
|
+
### Standalone (pulls image from Docker Hub)
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
cp .env.example .env # then fill in credentials
|
|
68
|
+
docker compose -f docker-compose.standalone.yml up -d
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Development (builds from source)
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
cp .env.example .env
|
|
75
|
+
docker compose up -d # uses docker-compose.yml which builds locally
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Testing with curl
|
|
81
|
+
|
|
82
|
+
### Initialize
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
curl -s -X POST http://localhost:8888/mcp \
|
|
86
|
+
-H "Content-Type: application/json" \
|
|
87
|
+
-H "Accept: application/json, text/event-stream" \
|
|
88
|
+
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### List tools
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
curl -s -X POST http://localhost:8888/mcp \
|
|
95
|
+
-H "Content-Type: application/json" \
|
|
96
|
+
-H "Accept: application/json, text/event-stream" \
|
|
97
|
+
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### Call a tool
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
curl -s -X POST http://localhost:8888/mcp \
|
|
104
|
+
-H "Content-Type: application/json" \
|
|
105
|
+
-H "Accept: application/json, text/event-stream" \
|
|
106
|
+
-d '{
|
|
107
|
+
"jsonrpc": "2.0",
|
|
108
|
+
"id": 3,
|
|
109
|
+
"method": "tools/call",
|
|
110
|
+
"params": {
|
|
111
|
+
"name": "list_pipelines",
|
|
112
|
+
"arguments": { "projectId": "MyProject" }
|
|
113
|
+
}
|
|
114
|
+
}'
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## On-prem (Azure DevOps Server) notes
|
|
120
|
+
|
|
121
|
+
- `AZURE_DEVOPS_ORG_URL` = collection URL only: `https://host/tfs/Collection`
|
|
122
|
+
- Project name goes in `AZURE_DEVOPS_DEFAULT_PROJECT`
|
|
123
|
+
- Use `AZURE_DEVOPS_AUTH_METHOD=pat`
|
|
124
|
+
- Set `AZURE_DEVOPS_API_VERSION` to match your server version
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## GitHub Actions secrets required
|
|
129
|
+
|
|
130
|
+
To push images from CI, add these secrets to your repository:
|
|
131
|
+
|
|
132
|
+
| Secret | Description |
|
|
133
|
+
|--------|-------------|
|
|
134
|
+
| `DOCKERHUB_USERNAME` | Your Docker Hub username |
|
|
135
|
+
| `DOCKERHUB_TOKEN` | Docker Hub access token (Settings → Security → New Access Token) |
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Authentication Examples
|
|
2
|
+
|
|
3
|
+
This directory contains example `.env` files for different authentication methods supported by the Azure DevOps MCP Server.
|
|
4
|
+
|
|
5
|
+
## Available Examples
|
|
6
|
+
|
|
7
|
+
1. **[pat-authentication.env](./pat-authentication.env)** - Example configuration for Personal Access Token (PAT) authentication
|
|
8
|
+
2. **[azure-identity-authentication.env](./azure-identity-authentication.env)** - Example configuration for Azure Identity (DefaultAzureCredential) authentication
|
|
9
|
+
3. **[azure-cli-authentication.env](./azure-cli-authentication.env)** - Example configuration for Azure CLI authentication
|
|
10
|
+
|
|
11
|
+
## How to Use These Examples
|
|
12
|
+
|
|
13
|
+
1. Choose the authentication method that best suits your needs
|
|
14
|
+
2. Copy the corresponding example file to the root of your project as `.env`
|
|
15
|
+
3. Replace the placeholder values with your actual values
|
|
16
|
+
4. Start the Azure DevOps MCP Server
|
|
17
|
+
|
|
18
|
+
For example:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Copy the PAT authentication example
|
|
22
|
+
cp docs/examples/pat-authentication.env .env
|
|
23
|
+
|
|
24
|
+
# Edit the .env file with your values
|
|
25
|
+
nano .env
|
|
26
|
+
|
|
27
|
+
# Start the server
|
|
28
|
+
npm start
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Additional Resources
|
|
32
|
+
|
|
33
|
+
For more detailed information about authentication methods, setup instructions, and troubleshooting, refer to the [Authentication Guide](../authentication.md).
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Example .env file for Azure CLI authentication
|
|
2
|
+
# Replace the values with your own
|
|
3
|
+
|
|
4
|
+
# Authentication method (required)
|
|
5
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-cli
|
|
6
|
+
|
|
7
|
+
# Azure DevOps organization URL (required)
|
|
8
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
9
|
+
|
|
10
|
+
# Default project to use when not specified (optional)
|
|
11
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=your-default-project
|
|
12
|
+
|
|
13
|
+
# API Version to use (optional, defaults to latest)
|
|
14
|
+
# AZURE_DEVOPS_API_VERSION=6.0
|
|
15
|
+
|
|
16
|
+
# Logging Level (optional)
|
|
17
|
+
LOG_LEVEL=info
|
|
18
|
+
|
|
19
|
+
# Note: This server uses stdio for communication with the MCP client,
|
|
20
|
+
# not HTTP. It does not listen on a network port.
|
|
21
|
+
|
|
22
|
+
# Note: Before using Azure CLI authentication, make sure you have:
|
|
23
|
+
# 1. Installed the Azure CLI (https://docs.microsoft.com/cli/azure/install-azure-cli)
|
|
24
|
+
# 2. Logged in with 'az login'
|
|
25
|
+
# 3. Verified your account has access to the Azure DevOps organization
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Example .env file for Azure Identity (DefaultAzureCredential) authentication
|
|
2
|
+
# Replace the values with your own
|
|
3
|
+
|
|
4
|
+
# Authentication method (required)
|
|
5
|
+
AZURE_DEVOPS_AUTH_METHOD=azure-identity
|
|
6
|
+
|
|
7
|
+
# Azure DevOps organization URL (required)
|
|
8
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
9
|
+
|
|
10
|
+
# Default project to use when not specified (optional)
|
|
11
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=your-default-project
|
|
12
|
+
|
|
13
|
+
# API Version to use (optional, defaults to latest)
|
|
14
|
+
# AZURE_DEVOPS_API_VERSION=6.0
|
|
15
|
+
|
|
16
|
+
# Azure AD tenant ID (required for service principal authentication)
|
|
17
|
+
# AZURE_TENANT_ID=your-tenant-id
|
|
18
|
+
|
|
19
|
+
# Azure AD client ID (required for service principal authentication)
|
|
20
|
+
# AZURE_CLIENT_ID=your-client-id
|
|
21
|
+
|
|
22
|
+
# Azure AD client secret (required for service principal authentication)
|
|
23
|
+
# AZURE_CLIENT_SECRET=your-client-secret
|
|
24
|
+
|
|
25
|
+
# Logging Level (optional)
|
|
26
|
+
LOG_LEVEL=info
|
|
27
|
+
|
|
28
|
+
# Note: This server uses stdio for communication with the MCP client,
|
|
29
|
+
# not HTTP. It does not listen on a network port.
|
|
30
|
+
|
|
31
|
+
# Note: When using DefaultAzureCredential, you don't need to set AZURE_TENANT_ID,
|
|
32
|
+
# AZURE_CLIENT_ID, and AZURE_CLIENT_SECRET if you're using other credential types
|
|
33
|
+
# like Managed Identity or Azure CLI.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Example .env file for Personal Access Token (PAT) authentication
|
|
2
|
+
# Replace the values with your own
|
|
3
|
+
|
|
4
|
+
# Authentication method (required)
|
|
5
|
+
AZURE_DEVOPS_AUTH_METHOD=pat
|
|
6
|
+
|
|
7
|
+
# Azure DevOps organization URL (required)
|
|
8
|
+
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
|
|
9
|
+
|
|
10
|
+
# Personal Access Token (required for PAT authentication)
|
|
11
|
+
# Create one at: https://dev.azure.com/your-organization/_usersSettings/tokens
|
|
12
|
+
AZURE_DEVOPS_PAT=your-personal-access-token
|
|
13
|
+
|
|
14
|
+
# Default project to use when not specified (optional)
|
|
15
|
+
AZURE_DEVOPS_DEFAULT_PROJECT=your-default-project
|
|
16
|
+
|
|
17
|
+
# API Version to use (optional, defaults to latest)
|
|
18
|
+
# AZURE_DEVOPS_API_VERSION=6.0
|
|
19
|
+
|
|
20
|
+
# Logging Level (optional)
|
|
21
|
+
LOG_LEVEL=info
|
|
22
|
+
|
|
23
|
+
# Note: This server uses stdio for communication with the MCP client,
|
|
24
|
+
# not HTTP. It does not listen on a network port.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Researching Azure DevOps REST APIs (Cloud + Server)
|
|
2
|
+
|
|
3
|
+
Source of truth: clone and browse the MicrosoftDocs REST API specs repo (Swagger 2.0 JSON).
|
|
4
|
+
If docs and specs disagree, treat specs as primary for request shapes and versions.
|
|
5
|
+
Repo: https://github.com/MicrosoftDocs/vsts-rest-api-specs.git
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
- Prefer cloning to a temporary location (ex: /tmp). Ask the human partner for a preferred location.
|
|
10
|
+
- Default path for this repo: ~/repos/vsts-rest-api-specs
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# preferred: ask partner for target path
|
|
14
|
+
git clone https://github.com/MicrosoftDocs/vsts-rest-api-specs.git /tmp/vsts-rest-api-specs
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Repo layout (core)
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
vsts-rest-api-specs/
|
|
21
|
+
specification/
|
|
22
|
+
<area>/
|
|
23
|
+
<version>/
|
|
24
|
+
<area>.json
|
|
25
|
+
httpExamples/
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Notes:
|
|
29
|
+
- Each `<area>` is an API area (build, git, wit, work, etc).
|
|
30
|
+
- Each `<version>` is an API version folder.
|
|
31
|
+
- Most version folders include a single `<area>.json` Swagger file and optional `httpExamples/`.
|
|
32
|
+
- `httpExamples/` contains request/response JSON (file names include HTTP method + operation).
|
|
33
|
+
|
|
34
|
+
## Versions: Services vs Server
|
|
35
|
+
|
|
36
|
+
- Azure DevOps Services (cloud): numeric folders like `5.0`, `6.1`, `7.2`.
|
|
37
|
+
- Azure DevOps Server (on‑prem): folders like `azure-devops-server-7.0`, `azure-devops-server-7.1`.
|
|
38
|
+
- Older TFS: folders like `tfs-4.1`.
|
|
39
|
+
|
|
40
|
+
Rule of thumb:
|
|
41
|
+
- Start with the exact server version folder if it exists.
|
|
42
|
+
- If missing, drop to the closest lower version for that area.
|
|
43
|
+
- Server lags Services; some areas are Services-only.
|
|
44
|
+
|
|
45
|
+
## How to find the right spec
|
|
46
|
+
|
|
47
|
+
1. Identify area: use `ls specification` to find the service name.
|
|
48
|
+
2. Pick version folder: cloud vs server rules above.
|
|
49
|
+
3. Open `<area>.json` and inspect:
|
|
50
|
+
- `info.version` (often includes `-preview` and optional `.n`)
|
|
51
|
+
- `paths` (endpoints)
|
|
52
|
+
- `parameters` (look for `api-Version-*` entries; descriptions include exact `api-version` values)
|
|
53
|
+
- `definitions` (request/response models)
|
|
54
|
+
4. Check `httpExamples/` for concrete request/response samples.
|
|
55
|
+
5. Use path placeholders: `{organization}` (Services) maps to org; on‑prem maps to collection.
|
|
56
|
+
|
|
57
|
+
## Helpful local searches
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
# find an area by name
|
|
61
|
+
rg --files -g 'git.json' specification
|
|
62
|
+
|
|
63
|
+
# scan endpoints for a keyword
|
|
64
|
+
rg -n "_apis" specification/git/7.2/git.json
|
|
65
|
+
|
|
66
|
+
# see path placeholders
|
|
67
|
+
rg -n '\\{organization\\}|\\{project\\}' specification/build/7.2/build.json
|
|
68
|
+
|
|
69
|
+
# find api-version parameters
|
|
70
|
+
rg -n '"api-version"' specification/build/7.2/build.json
|
|
71
|
+
|
|
72
|
+
# confirm area metadata
|
|
73
|
+
rg -n 'x-ms-vss-(area|resource-area-id)' specification/build/7.2/build.json
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Azure DevOps Server (on‑prem) specifics
|
|
77
|
+
|
|
78
|
+
- Specs still list `host: dev.azure.com` in many files; on‑prem uses your server host instead.
|
|
79
|
+
- Base path may include a collection segment (ex: `/tfs/{collection}`); use your server's actual base URL.
|
|
80
|
+
- Use the on‑prem version folder as the authority for routes and parameters.
|
|
81
|
+
- `api-version` is still required; use the exact value from the on‑prem spec.
|
|
82
|
+
- Check `httpExamples/` for base paths and collection/project shapes.
|
|
83
|
+
|
|
84
|
+
## Extra tips
|
|
85
|
+
|
|
86
|
+
- Many areas share naming: `build`, `git`, `wit`, `work`, `distributedTask`, `serviceEndpoint`, etc.
|
|
87
|
+
- Preview APIs show `-preview` in `info.version`; expect breaking changes.
|
|
88
|
+
- If you’re unsure which area owns an endpoint, search across specs with `rg -n`.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# llm-tldr CLI usage (uv)
|
|
2
|
+
|
|
3
|
+
Scope: CLI only. Skip MCP. Use uv instead of pip.
|
|
4
|
+
|
|
5
|
+
## Install (uv)
|
|
6
|
+
|
|
7
|
+
- Install once: `uv tool install llm-tldr`
|
|
8
|
+
|
|
9
|
+
## Core workflow
|
|
10
|
+
|
|
11
|
+
- `tldr tree <path>` for structure
|
|
12
|
+
- `tldr structure <path> --lang typescript` for symbols
|
|
13
|
+
- `tldr search "<regex>" <path>` for entry points
|
|
14
|
+
- `tldr extract <file> --function <name> --lang typescript` for focused details
|
|
15
|
+
- `tldr context <entry> --project . --lang typescript` for call graph context
|
|
16
|
+
|
|
17
|
+
## Indexing + daemon
|
|
18
|
+
|
|
19
|
+
- `tldr warm .` builds call graph cache
|
|
20
|
+
- `tldr daemon status` check daemon
|
|
21
|
+
- `tldr daemon notify <file> --project .` after edits (reindex after threshold)
|
|
22
|
+
|
|
23
|
+
## Semantic search (optional, heavy download)
|
|
24
|
+
|
|
25
|
+
- `tldr semantic index . --lang all --model all-MiniLM-L6-v2`
|
|
26
|
+
- `tldr semantic search "<query>" --path . --lang typescript`
|
|
27
|
+
|
|
28
|
+
## Example: URL-based server selection in this repo
|
|
29
|
+
|
|
30
|
+
1) Locate entry points:
|
|
31
|
+
- `tldr search "serverUrl|organizationUrl|extractOrgFromUrl" src`
|
|
32
|
+
2) Inspect extraction logic:
|
|
33
|
+
- `tldr extract src/features/users/get-me/feature.ts --function extractOrgFromUrl --lang typescript`
|
|
34
|
+
- `tldr extract src/features/search/search-code/feature.ts --function extractOrgFromUrl --lang typescript`
|
|
35
|
+
3) Check org derivation:
|
|
36
|
+
- `tldr extract src/utils/environment.ts --function getOrgNameFromUrl --lang typescript`
|
|
37
|
+
4) Summarize how URL patterns drive which host or org is used.
|