Azure DevOps MCP Server

Azure DevOps MCP Server

Azure DevOps MCP Serverは、AIアシスタント（ClaudeやCursor AIなど）がAzure DevOpsリソースと安全にやり取りできるようにするModel Context Protocol（MCP）のサーバー実装です。これは、自然言語とAIによる自動化を通じて、DevOpsワークフローをよりアクセスしやすくします。

Author: Tiberriver256


プロトコルを表示

Azure DevOps MCP Serverとは？

Azure DevOps MCP Serverは、AIモデルとAzure DevOps APIの間の橋渡しをします。これにより、大規模言語モデルがAzure DevOpsプロジェクト、作業項目、リポジトリ、パイプライン、プルリクエストなどとやり取りできるようになります。これらの機能は標準化されたMCPツールとして公開され、安全な認証と様々なAIプラットフォームへの柔軟な統合をサポートしています。

設定方法

  1. Node.js（v16+）とnpmまたはyarnをインストールします。
  2. Azure DevOps組織にアクセスできることを確認し、必要な認証資格情報（Personal Access Token、Azure Identity、またはAzure CLI）を用意します。
  3. MCPサーバーの設定を設定ファイルに追加して、AIホスト（例：Claude Desktop、Cursor AI）と統合します。設定の例：
    • Azure Identityを使用する場合（az loginを使用）： 
      {
  "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"
      }
    }
  }
}
    • 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"
      }
    }
  }
}
  4. その他の環境変数や高度な認証（サービスプリンシパル、CLI）については、公式ドキュメントを参照してください。

使用方法

  • 設定した内容を使用してAzure DevOps MCP Serverを起動します。通常、AIアシスタントホスト（Claude Desktop、Cursor AIなど）を通じて行います。
  • サーバーが起動したら、AIモデルはDevOps関連アクションのために利用可能なツール（関数）を検索して呼び出すことができます。たとえば、プロジェクトの一覧表示、作業項目の作成、リポジトリの管理、パイプラインのトリガーなどです。
  • ナチュラル言語のプロンプトを使用してAIアシスタントに指示します。アシスタントはMCPを通じてAzure DevOpsで求められた操作を実行します。
  • すべての操作は選択した認証方法を使用して安全に行われ、結果はアシスタントやワークフローに返されます。

主な機能

  • Azure DevOpsとAIアシスタントを統合するための標準化された拡張可能なプロトコル。
  • Personal Access Token、Azure Identity、およびAzure CLIによる複数の認証モードをサポート。
  • DevOps機能領域（プロジェクト、作業項目、リポジトリ、パイプラインなど）ごとに整理されたモジュラー構造。
  • DevOpsタスクの読み取り、検索、変更、自動化のための豊富なMCPツール。
  • ユーザーの権限を尊重し、クラウドおよび（オプションで）ローカルリソースへの安全なアクセス。
  • 人気のAIホストやIDEとの簡単な設定と統合。

利用例

  • AI駆動のコマンドを使用してDevOpsワークフローやプロセスを自動化します（例：プロンプトによる作業項目の作成や更新）。
  • Azure DevOpsの情報やアクションをLLM駆動のチャットボットやコーディングアシスタントに統合します。
  • 自然言語クエリを使用して迅速にコード、作業項目、またはドキュメントを検索します。
  • AIエージェントがビルドをトリガーしたり、プルリクエストを管理したり、パイプラインの実行を監視します。
  • 会話型インターフェースを使用してエンジニアリングチームの生産性とDevOpsの可視性を向上させます。

よくある質問

Q1: サポートされている認証方法は何ですか？
A: サーバーは、Personal Access Token（PAT）、Azure Identity（DefaultAzureCredential）およびAzure CLIによる認証をサポートしています。各方法には特定のセットアップ手順があります。詳細についてはドキュメントを参照してください。

Q2: AIのアクセスを特定のプロジェクトやリポジトリに制限できますか？
A: はい。アクセスは提供された資格情報と権限に基づいて制御されます。AIアシスタントは、認証されたアカウントがアクセス可能なプロジェクトやリソースにのみアクセスできます。

Q3: 認証に失敗した場合やサーバーがAzure DevOpsに接続できない場合はどうすればよいですか？
A: 一般的なトラブルシューティング手順には、資格情報の有効性を確認する、権限スコープをチェックする、ネットワーク接続を確認する、及びログで設定ミスをレビューすることが含まれます。詳細なトラブルシューティングのヒントについては、認証ガイドを参照してください。

Q4: 利用可能なツールのセットを更新または拡張するにはどうすればよいですか？
A: サーバーはモジュラーです。新しいツールや機能モジュールは、コードベースを更新し、新しいツールハンドラーを登録することで追加できます。支援が必要な場合は、貢献ガイドを参照してください。

Q5: このサーバーをローカルマシンで実行するのは安全ですか？
A: はい、環境を制御し、認証資格情報を保護する限り安全です。サーバーはデフォルトで外部にサービスを公開しません。