Cursor Azure Devops MCP

🚀 Azure DevOps カーソルツールの使用

Azure DevOps カーソルツールは、Azure DevOps サービスとの相互作用に特化した強力なツールです。コマンドラインやスクリプトを通じて、作業項目の照会、コードリポジトリの管理、プルリクエストの操作、テスト管理など、様々な機能を提供します。

🚀 クイックスタート

Azure DevOps カーソルツールを使用するには、まずインストールと環境設定が必要です。以下の手順に従ってセットアップを行ってください。

✨ 主な機能

• コードリポジトリ管理：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) を指定します。

💻 使用例

基本的な使用法

azdo-cursor --help          # ヘルプ情報を表示
azdo-cursor work-items     # 作業項目を取得
azdo-cursor pr [REPO_ID]    # プルリクエストを取得
azdo-cursor test-plans      # テスト計画を取得

高度な使用法

例 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

📚 ドキュメント

ツールコマンドの詳細

作業項目関連コマンド

• 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 コマンドを使用して、利用可能なすべてのテスト計画を一覧表示し、必要な計画を選択して実行します。
• 結果分析：テストが完了したら、生成された結果レポートを確認して、潜在的な問題を特定します。

エラー処理

一般的なエラー

• 認証失敗：環境変数が正しく設定されていることを確認し、特に AZURE_DEVOPS_TOKEN が有効であることを確認します。
• プロジェクトが存在しない：指定した projectId が有効であり、ユーザーが適切な権限を持っていることを確認します。

高度な機能

自動化スクリプト

複数のコマンドを組み合わせて、複雑なタスクを自動化するスクリプトを作成できます。

# 例：すべての未クローズの作業項目を取得し、ファイルに出力する
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

テスト管理ツール

機能概要

テスト管理機能を使用すると、コマンドラインからテスト計画を実行し、自動的に結果レポートを生成できます。

コマンド例

# すべてのテスト計画を取得する
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. 定期的な更新：ツールの更新を定期的に確認し、新機能やパフォーマンスの改善を取得します。

📄 ライセンス

該READMEにはライセンス情報が記載されていないため、このセクションは省略されています。

問題とフィードバック

使用中に何か問題が発生した場合は、以下の方法でフィードバックを提供してください。

• GitHub Issues を投稿する: https://github.com/azdo-cursor/issues
• ユーザーコミュニティで議論する: Discord コミュニティ

付録

エラーコード

出力形式

• JSON：標準的な JSON 構造で、後続の処理に便利です。
• Text：読みやすいテキスト出力です。

サポートされるブランチ

• Main：安定版
• Dev：最新機能の開発版

更新履歴

バージョン 1.0.0 (2023-10-15)

• テスト管理機能を追加しました。
• 作業項目コマンドのパフォーマンスを改善しました。
• 認証関連のバグを修正しました。

バージョン 0.9.0 (2023-08-14)

• 基本的なプロジェクト管理とプルリクエスト機能を含む初期リリースです。