Cursor Azure Devops MCP

🚀 使用 Azure DevOps 遊標工具

Azure DevOps 遊標工具功能強大，可與 Azure DevOps 服務進行交互。用戶能通過命令行或腳本執行各類操作，如查詢工作項、管理代碼倉庫、處理拉取請求以及開展測試管理等。

🚀 快速開始

本工具支持在 Windows、macOS、Linux 系統上運行，需 Node.js v12 或更高版本，Npm 6.0 或更高版本。

安裝步驟

1. 使用 Node 包管理器 (npm) 安裝工具：

   npm install -g azdo-cursor
   

2. 驗證安裝是否成功：

   azdo-cursor --version
   

環境變量配置

為連接到 Azure DevOps，需設置以下環境變量：

• AZURE_DEVOPS_ORG_URL：指定組織 URL（例如：https://dev.azure.com/your-org）。
• AZURE_DEVOPS_PROJECT：可選，默認項目名稱。
• AZURE_DEVOPS_TOKEN：必需，個人訪問令牌 (PAT)。

✨ 主要特性

基本命令

以下是一些常用的工具命令：

azdo-cursor --help          # 顯示幫助信息
azdo-cursor work-items     # 獲取工作項
azdo-cursor pr [REPO_ID]    # 獲取拉取請求
azdo-cursor test-plans      # 獲取測試計劃

高級功能

• 代碼倉庫管理：提供對 Git 倉庫的全面支持，包括提交、分支和標籤操作。
• 拉取請求處理：支持創建、更新和刪除拉取請求，並能查看詳細評論。
• 工作項跟蹤：可以查詢、創建和更新工作項，支持附件和評論管理。

📦 安裝指南

系統要求

• 操作系統：支持 Windows, macOS, Linux。
• Node.js 版本：v12 或更高版本。
• Npm 版本：6.0 或更高版本。

安裝步驟

1. 使用 Node 包管理器 (npm) 安裝工具：

   npm install -g azdo-cursor
   

2. 驗證安裝是否成功：

   azdo-cursor --version
   

環境變量配置

為了連接到 Azure DevOps，需要設置以下環境變量：

• AZURE_DEVOPS_ORG_URL：指定組織 URL（例如：https://dev.azure.com/your-org）。
• AZURE_DEVOPS_PROJECT：可選，默認項目名稱。
• AZURE_DEVOPS_TOKEN：必需，個人訪問令牌 (PAT)。

💻 使用示例

基礎用法

示例 1: 連接到 Azure DevOps

export AZURE_DEVOPS_ORG_URL="https://dev.azure.com/contoso"
export AZURE_DEVOPS_PROJECT="DefaultCollection"
export AZURE_DEVOPS_TOKEN="your-pat-token"

azdo-cursor work-items --projectId=project001

示例 2: 獲取拉取請求

azdo-cursor pr repo001 \
    --branch "main" \
    --status "all" \
    --output json > pull-requests.json

高級用法

自動化腳本

通過組合多個命令，可以創建自動化腳本來完成複雜任務。例如：

# 示例：獲取所有未關閉的工作項並輸出到文件
azdo-cursor work-items --projectId=project001 --filterByState=open --output=json > open-issues.json

# 示例：批量更新工作項狀態
for i in $(cat open-issues.json | jq -r '.[].id'); do azdo-cursor work-item $i --state Resolved; done

日誌記錄

工具支持詳細的日誌輸出，便於調試和監控操作：

azdo-cursor pr repo001 --verbose > pull-request.log 2>&1

📚 詳細文檔

工具命令詳解

工作項相關命令

• work-items：獲取項目中的所有工作項。
• work-item <id>：根據 ID 獲取特定工作項。

拉取請求相關命令

• pr [REPO_ID]：獲取指定倉庫的所有拉取請求。
• pr getById <REPO_ID> <PR_ID>：通過倉庫 ID 和 PR ID 獲取具體拉取請求信息。
• create-pr [REPO_ID] --title "標題" --description "描述"：創建新的拉取請求。

測試管理命令

• test-plans：列出所有測試計劃。
• test-suite <SUITE_ID>：執行指定測試套件並生成結果報告。

詳細參數

工作項命令參數

拉取請求命令參數

測試管理命令參數

使用場景

項目管理

• 查詢任務：通過 work-items 命令快速查找所有待辦事項。
• 更新狀態：對特定工作項進行狀態更新，如 azdo-cursor work-item 123 --state Resolved。

開發流程

• 創建 PR：在提交代碼前，使用命令創建拉取請求以供審查。
• 獲取反饋：查看所有相關評論並根據反饋修改代碼。

測試執行

• 計劃管理：使用 test-plans 列出所有可用測試計劃，並通過指定參數選擇需要執行的計劃。
• 結果分析：執行完成後，查看生成的結果報告以識別潛在問題。

測試管理工具

功能概述

測試管理功能允許用戶通過命令行執行測試計劃，並能自動生成結果報告。

命令示例

# 獲取所有測試計劃
azdo-cursor test-plans

# 執行特定測試套件
azdo-cursor test-suite 123 --runMode parallel --resultFormat json > test-results.json

參數說明

• --planId：指定要執行的測試計劃 ID。
• --runMode：設置運行模式，支持並行或串行執行。
• --resultFormat：控制結果輸出格式，支持 JSON 和 XML。

最佳實踐

1. 配置管理：始終保持環境變量是最新的，並確保有適當的權限。
2. 日誌監控：在進行大規模操作時，啟用詳細日誌記錄以便排查問題。
3. 定期更新：定期檢查工具更新，以獲取新功能和性能改進。

🔧 技術細節

錯誤處理

常見錯誤

1. 認證失敗：
   • 檢查環境變量是否正確設置，特別是 AZURE_DEVOPS_TOKEN 是否有效。
2. 項目不存在：
   • 確保指定的 projectId 是有效的，並且用戶擁有相應權限。

附錄

錯誤代碼

輸出格式

• JSON：標準的 JSON 結構，便於後續處理。
• Text：可讀性高的文本輸出。

支持的分支

• Main：穩定版本
• Dev：最新功能開發版本

更新日誌

版本 1.0.0 (2023-10-15)

• 新增測試管理功能
• 改進工作項命令的性能
• 修復認證相關的 bug

版本 0.9.0 (2023-08-14)

• 初始發佈，包含基本的項目管理和拉取請求功能

📄 許可證

文檔未提及相關許可證信息。

問題與反饋

如果在使用過程中遇到任何問題，請通過以下方式提供反饋：

• 提交 GitHub Issues: https://github.com/azdo-cursor/issues
• 加入用戶社區討論: Discord 社區