azure-devops-mcp-server MCP Server

azure-devops-mcp-server MCP サーバー

自然言語を使って Azure DevOps をより簡単に操作できます。

これは、axios を介して Azure DevOps REST API を使用し、Azure DevOps Work Items を操作するために設計された TypeScript ベースの MCP サーバーです。

機能

ツール

このサーバーでは、Azure DevOps のリソースを管理するために次のツールを利用できます。

Work Item の基本操作

• create_work_item：Azure DevOps に新しい Work Item（例：User Story、Bug、Task）を作成します。
  • 必須パラメーター：type（種類）、title（タイトル）。
  • オプションのパラメーター：projectName（プロジェクト名。デフォルトでは、サーバーが検出した最初のプロジェクト）、description（説明）、areaPath（エリアパス。デフォルトでは対象プロジェクト名）、iterationPath（イテレーションパス。デフォルトでは対象プロジェクト名）、assignedTo（割り当て先）、tags（タグ）。
• get_work_item_details：ID に基づいて Azure DevOps Work Item の詳細を取得します。
  • 必須パラメーター：id（Work Item ID）。
  • オプションのパラメーター：fields（取得するフィールドのリスト。デフォルトではすべてのフィールドを返します）、summarize（ブール値。true に設定すると概要情報のみを返します。デフォルトは false）。
• update_work_item：既存の Azure DevOps Work Item のフィールド（例：状態、割り当て先）を更新します。
  • 必須パラメーター：id（Work Item ID）、updates（更新するフィールドと値を含むオブジェクト）。
  • オプションのパラメーター：comment（更新コメント）。
• delete_work_item：指定した Azure DevOps Work Item を削除し、リサイクルビンに移動します。🆕
  • 必須パラメーター：id（Work Item ID）。
  • オプションのパラメーター：destroy（完全に削除するかどうか。デフォルトは false）、projectName（プロジェクト名）。

一括操作 🆕

• get_work_items_batch：複数の Azure DevOps Work Items を一括取得します（最大200件）。
  • 必須パラメーター：ids（Work Item ID のリスト）。
  • オプションのパラメーター：fields（フィールドのリスト）、asOf（指定した時点）、expand（展開オプション）。
• batch_update_work_items：複数の Azure DevOps Work Items を一括更新します。1回のリクエストで、複数の作成、更新、削除操作を実行できます。
  • 必須パラメーター：operations（一括操作のリスト）。
  • オプションのパラメーター：bypassRules（ルールをスキップ）、suppressNotifications（通知を抑制）。

検索とクエリ

• search_work_items：Azure DevOps Work Items を検索します。さまざまなフィルター条件と並べ替えオプションを利用できます。
  • オプションのパラメーター：
    • query：検索キーワード（タイトル、説明、ID を検索）
    • projectName：プロジェクト名（デフォルトでは、サーバーが検出した最初のプロジェクト）
    • workItemType：Work Item の種類（例：'User Story'、'Bug'）
    • state：状態によるフィルター（例：'Active'、'Closed'）
    • assignedTo：割り当て先の表示名またはメールアドレス
    • tags：タグによるフィルター（セミコロン区切り。複数のタグによる OR 条件に対応）
    • createdAfter：作成日時によるフィルター（ISO 8601 形式。例：'2024-03-01'）
    • updatedAfter：更新日時によるフィルター（ISO 8601 形式。例：'2024-03-01'）
    • fields：返すフィールドのカスタムリスト（デフォルトでは、ID、タイトル、状態、種類、割り当て先、タグ、作成／更新日時および担当者を含みます）
    • orderBy：並べ替え方法（'ChangedDate'、'CreatedDate'、'State'、'ID' に対応し、'ASC' または 'DESC' を追加できます）
    • top：返す件数の上限（デフォルトは 50、最大 200）
  • 返される形式：
    • 合計件数と、さらに結果があるかどうか
    • URL リンクを含む各項目の詳細情報
    • 書式設定された概要表示

プロジェクト管理

• list_projects：Azure DevOps 組織内のすべてのプロジェクトを一覧表示します。
• get_project_details：プロジェクト ID または名前に基づいて、Azure DevOps プロジェクトの詳細を取得します。
  • 必須パラメーター：projectIdOrName（プロジェクト ID または名前）。

統合とリンク

• link_commit_to_work_item：Git Commit を Azure DevOps Work Item にリンクします。
  • 必須パラメーター：workItemId（Work Item ID）、commitSha（Commit SHA）、repositoryName（リポジトリ名）。
  • オプションのパラメーター：projectName（プロジェクト名）、comment（リンクの説明）。
  • 注意：以前のバージョンで、組織 URL の末尾にあるスラッシュが原因でリンクに誤りが生じる可能性があった問題を修正しました。
• link_parent_work_item：Work Item の親子関係を作成します（childId を parentId の子として設定します）。
  • 必須パラメーター：childId（子 Work Item ID）、parentId（親 Work Item ID）
  • オプションのパラメーター：comment（リンクの説明）
  • 機能の説明：指定した Work Item を別の Work Item の子として設定し、説明文を追加できます。

添付ファイルとコメント

• list_work_item_attachments：指定した Azure DevOps Work Item の添付ファイル一覧を、ダウンロード URL とともに取得します。
  • 必須パラメーター：workItemId（Work Item ID）。
  • オプションのパラメーター：projectName（プロジェクト名）。
• add_issue_comment：既存の Azure DevOps Work Item にコメントを追加します。
  • 必須パラメーター：workItemId（Work Item ID）、comment（コメント内容）。

🆕 バージョン 0.2.0 の更新

新機能

• 一括操作への対応：get_work_items_batch と batch_update_work_items ツールを追加し、大量の Work Items の処理効率を大幅に向上
• 削除機能：delete_work_item ツールを追加し、論理削除（リサイクルビンへの移動）と完全削除に対応
• API バージョンの更新：7.2-preview から安定版の 7.2 にアップグレード

パフォーマンスの改善

• 一括取得では最大 200 件の Work Items に対応
• 一括更新では複合操作（作成、更新、削除）に対応
• エラー処理と応答形式を最適化

API との互換性

• Azure DevOps REST API 7.2 と完全に互換
• 主要な Work Item 操作すべてに対応
• 下位互換性を維持

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe", // Or your Node.js path
      "args": [
        "C:\\Tools\\Cline\\MCP\\azure-devops-mcp-server\\build\\index.js" // Adjust path if needed
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // e.g., https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

重要： YOUR_ORG_URL を Azure DevOps 組織の URL に、YOUR_PERSONAL_ACCESS_TOKEN を Work Item の読み取りおよび書き込み権限を持つ有効な Personal Access Token (PAT) に置き換えてください。

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を提供します。

参考資料

• Azure DevOps REST API リファレンス