Azure DevOps MCP サーバー

Azure DevOps 用のモデル コンテキスト プロトコル (MCP) サーバー実装。これにより、AI アシスタントは標準化されたプロトコルを通じて Azure DevOps API と対話できるようになります。

概要

このサーバーはAzure DevOps向けのモデルコンテキストプロトコル（MCP）を実装しており、ClaudeのようなAIアシスタントがAzure DevOpsリソースと安全にやり取りできるようにします。このサーバーはAIモデルとAzure DevOps API間の橋渡しとして機能し、以下の標準化された方法を提供します。

• プロジェクト、作業項目、リポジトリなどにアクセスして管理する

• 作業項目、ブランチ、プルリクエストの作成と更新

• 自然言語で一般的な DevOps ワークフローを実行する

• 標準化されたリソース URI を介してリポジトリ コンテンツにアクセスする

• Azure DevOps リソースを安全に認証して操作する

Related MCP server: Azure DevOps MCP Server

サーバー構造

このサーバーは、AIアシスタントとの通信にモデルコンテキストプロトコル（MCP）を基盤として構築されています。Azure DevOpsリソースとの連携に必要なツールとして、以下のものが提供されています。

• プロジェクト

• 作業項目

• リポジトリ

• プルリクエスト

• 支店

• パイプライン

コアコンポーネント

• AzureDevOpsServer : MCP サーバーを初期化し、ツールを登録するメイン サーバー クラス

• 機能モジュール: 機能領域 (作業項目、プロジェクト、リポジトリなど) 別に整理されています

• リクエストハンドラ:各機能モジュールはリクエストの識別と処理機能を提供します

• ツール ハンドラー: Azure DevOps の各操作のモジュール関数

• 構成: 組織 URL、PAT などの環境ベースの構成。

サーバーは機能ベースのアーキテクチャを採用しており、各機能領域（作業項目、プロジェクト、リポジトリなど）がそれぞれ独自のモジュールにカプセル化されています。これにより、コードベースの保守性が向上し、新機能の拡張が容易になります。

はじめる

前提条件

• Node.js (v16+)

• npmまたはyarn

• 適切なアクセス権を持つ Azure DevOps アカウント

• 認証資格情報（詳細については認証ガイドを参照してください）:

  • 個人アクセストークン（PAT）、または

  • Azure ID 資格情報、または

  • Azure CLI ログイン

NPXで実行

Claude Desktop/Cursor AI での使用

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

Azure ID 認証

az loginを使用して Azure CLI にログインしていることを確認してから、以下を追加します。

個人アクセストークン（PAT）認証

詳細な構成手順とその他の認証オプションについては、 『認証ガイド』を参照してください。

認証方法

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

サポートされている認証方法

1. パーソナルアクセストークン（PAT） - シンプルなトークンベースの認証

2. Azure Identity (DefaultAzureCredential) - Azure Identity SDK を使用した柔軟な認証

3. Azure CLI - Azure CLI ログインを使用した認証

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

環境変数

環境変数とその説明の完全なリストについては、 『認証ガイド』を参照してください。

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

認証のトラブルシューティング

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

一般的な問題は次のとおりです:

• 無効または期限切れの資格情報

• 権限が不十分です

• ネットワーク接続の問題

• 構成エラー

認証実装の詳細

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

利用可能なツール

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

ユーザーツール

• get_me : 認証されたユーザーの詳細 (ID、表示名、メール) を取得します。

整理ツール

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

プロジェクトツール

• list_projects : 組織内のすべてのプロジェクトを一覧表示する

• get_project : 特定のプロジェクトの詳細を取得する

• get_project_details : プロセス、作業項目の種類、チームなど、プロジェクトの包括的な詳細を取得します。

リポジトリツール

• list_repositories : プロジェクト内のすべてのリポジトリを一覧表示する

• get_repository : 特定のリポジトリの詳細を取得する

• get_repository_details : 統計や参照を含むリポジトリの詳細情報を取得します。

• 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 : カスタマイズ可能なパラメータでパイプラインの実行をトリガーする

ウィキツール

• get_wikis : プロジェクト内のすべてのウィキを一覧表示する

• get_wiki_page : 特定のWikiページのコンテンツをプレーンテキストとして取得する

プルリクエストツール

• create_pull_request - 新しいプルリクエストを作成する

• list_pull_requests - リポジトリ内のプルリクエストを一覧表示する

• add_pull_request_comment - プルリクエストにコメントを追加する

• get_pull_request_comments - プルリクエストからコメントを取得する

• update_pull_request - 既存のプルリクエストを更新します（タイトル、説明、ステータス、下書き状態、レビュー担当者、作業項目）

すべてのツールに関する包括的なドキュメントについては、ツールのドキュメントを参照してください。

貢献

貢献を歓迎します！貢献ガイドラインについては、 CONTRIBUTING.md をご覧ください。

スターの歴史

ライセンス

マサチューセッツ工科大学