Azure DevOps MCP Server

Azure DevOps MCP サーバー

Azure DevOps 用の Model Context Protocol（MCP）サーバー実装です。標準化されたプロトコルを通じて、AI アシスタントが Azure DevOps API を操作できます。

概要

このサーバーは、Azure DevOps 用の Model Context Protocol（MCP）を実装し、Claude などの AI アシスタントが Azure DevOps リソースを安全に操作できるようにします。サーバーは AI モデルと Azure DevOps API の橋渡しをし、次の操作を標準化された方法で行えるようにします。

• プロジェクト、作業項目、リポジトリなどへのアクセスと管理
• 作業項目、ブランチ、プルリクエストの作成と更新
• 自然言語による一般的な DevOps ワークフローの実行
• 標準化されたリソース URI によるリポジトリコンテンツへのアクセス
• Azure DevOps リソースの安全な認証と操作

サーバーの構成

このサーバーは、AI アシスタントとの通信に Model Context Protocol（MCP）を使用する構成です。次の Azure DevOps リソースを操作するツールを提供します。

• プロジェクト
• 作業項目
• リポジトリ
• プルリクエスト
• ブランチ
• パイプライン

コアコンポーネント

• AzureDevOpsServer：MCP サーバーを初期化し、ツールを登録するメインのサーバークラス
• ツールハンドラー：Azure DevOps の各操作に対応するモジュール式の関数
• 構成：組織 URL、PAT などの環境変数に基づく構成

はじめに

前提条件

• Node.js（v16 以降）
• npm または yarn
• 適切なアクセス権を持つ Azure DevOps アカウント
• 認証情報（詳細は認証ガイドを参照）：
  • Personal Access Token（PAT）、または
  • Azure Identity の認証情報、または
  • Azure CLI へのログイン

NPX での実行

Claude Desktop／Cursor AI での使用

Claude Desktop または Cursor AI と連携するには、次のいずれかの構成を構成ファイルに追加します。

Azure Identity 認証

az login で Azure CLI にログインしてから、次の内容を追加してください。

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

Personal Access Token（PAT）認証

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "pat",
        "AZURE_DEVOPS_PAT": "<YOUR_PAT>",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

詳細な構成手順やその他の認証方法については、認証ガイドを参照してください。

認証方法

このサーバーでは、Azure DevOps API に接続するための複数の認証方法を利用できます。詳細な設定手順、構成例、トラブルシューティングのヒントについては、認証ガイドを参照してください。

対応している認証方法

1. Personal Access Token（PAT） - シンプルなトークンベースの認証
2. Azure Identity（DefaultAzureCredential） - Azure Identity SDK を使用した柔軟な認証
3. Azure CLI - Azure CLI へのログインを使用した認証

各認証方法の構成ファイル例は、examples ディレクトリにあります。

環境変数

環境変数の完全な一覧と説明については、認証ガイドを参照してください。

主な環境変数は次のとおりです。

Variable	Description	Required	Default
AZURE_DEVOPS_AUTH_METHOD	認証方法（pat、azure-identity、またはazure-cli）。大文字と小文字は区別されません	いいえ	azure-identity
AZURE_DEVOPS_ORG_URL	Azure DevOps 組織の完全な URL	はい	-
AZURE_DEVOPS_PAT	個人用アクセストークン（PAT 認証用）	PAT 認証の場合のみ	-
AZURE_DEVOPS_DEFAULT_PROJECT	指定がない場合に使用する既定のプロジェクト	いいえ	-
AZURE_DEVOPS_API_VERSION	使用する API バージョン	いいえ	最新
AZURE_TENANT_ID	Azure AD テナント ID（サービスプリンシパル用）	サービスプリンシパルの場合のみ	-
AZURE_CLIENT_ID	Azure AD アプリケーション ID（サービスプリンシパル用）	サービスプリンシパルの場合のみ	-
AZURE_CLIENT_SECRET	Azure AD クライアントシークレット（サービスプリンシパル用）	サービスプリンシパルの場合のみ	-
LOG_LEVEL	ログレベル（debug、info、warn、error）	いいえ	info

認証に関するトラブルシューティング

各認証方法の詳しいトラブルシューティング情報については、認証ガイドを参照してください。

よくある問題は次のとおりです。

• 認証情報が無効または期限切れ
• 権限不足
• ネットワーク接続の問題
• 設定エラー

認証の実装に関する詳細

Azure DevOps MCP サーバーでの認証の実装に関する技術的な詳細については、認証ガイドおよびsrc/authディレクトリ内のソースコードを参照してください。

利用可能なツール

Azure DevOps MCP サーバーは、Azure DevOps リソースを操作するためのさまざまなツールを提供します。各ツールの詳しいドキュメントについては、対応するドキュメントを参照してください。

ユーザーツール

• get_me：認証済みユーザーの詳細（id、displayName、email）を取得します

組織ツール

• list_organizations：アクセス可能なすべての組織を一覧表示します

プロジェクトツール

• list_projects：組織内のすべてのプロジェクトを一覧表示します
• get_project：特定のプロジェクトの詳細を取得します
• get_project_details：プロセス、作業項目の種類、チームなど、プロジェクトの包括的な詳細を取得します

リポジトリツール

• list_repositories：プロジェクト内のすべてのリポジトリを一覧表示します
• get_repository：特定のリポジトリの詳細を取得します
• get_repository_details：統計情報や refs など、リポジトリの詳細情報を取得します
• get_file_content：リポジトリ内のファイルまたはディレクトリの内容を取得します

作業項目ツール

• get_work_item：ID を指定して作業項目を取得します
• create_work_item：新しい作業項目を作成します
• update_work_item：既存の作業項目を更新します
• list_work_items：プロジェクト内の作業項目を一覧表示します
• manage_work_item_link：作業項目間のリンクを追加、削除、または更新します

検索ツール

• search_code：プロジェクト内のリポジトリ全体からコードを検索します
• search_wiki：プロジェクト内の Wiki ページ全体からコンテンツを検索します
• search_work_items：Azure DevOps 内のプロジェクト全体から作業項目を検索します

パイプラインツール

• list_pipelines：プロジェクト内のパイプラインを一覧表示します
• get_pipeline：特定のパイプラインの詳細を取得します
• trigger_pipeline：カスタマイズ可能なパラメーターを指定してパイプラインの実行を開始します

Wiki ツール

• get_wikis：プロジェクト内のすべての Wiki を一覧表示します
• get_wiki_page：特定の Wiki ページのコンテンツをプレーンテキストで取得します

プルリクエストツール

• create_pull_request：リポジトリ内のブランチ間で新しいプルリクエストを作成します
• list_pull_requests：プロジェクトまたはリポジトリ内のプルリクエストを一覧表示し、絞り込みます
• get_pull_request_comments：特定のプルリクエストのコメントとコメントスレッドを取得します
• add_pull_request_comment：プルリクエストにコメントを追加します（既存のコメントへの返信、または新しいスレッドの作成）

すべてのツールの詳細については、ツールのドキュメントをご覧ください。

コントリビューション

コントリビューションを歓迎します！ガイドラインについてはCONTRIBUTING.mdをご覧ください。

スター履歴

ライセンス

MIT