remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Utilizes environment variables for configuration of organization URL, Personal Access Token, and default project settings.
Enables interaction with Git repositories in Azure DevOps, including accessing repository details and branch information.
Runs on Node.js to provide a server implementation for communicating with Azure DevOps resources via the Model Context Protocol.

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 リソースを安全に認証して操作する

サーバー構造

このサーバーは、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 にログインしていることを確認してから、以下を追加します。

{
  "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"
      }
    }
  }
}

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

認証方法

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

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

パーソナルアクセストークン（PAT） - シンプルなトークンベースの認証
Azure Identity (DefaultAzureCredential) - Azure Identity SDK を使用した柔軟な認証
Azure CLI - Azure CLI ログインを使用した認証

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

環境変数

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

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

変数	説明	必須	デフォルト
`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`	ログレベル（デバッグ、情報、警告、エラー）	いいえ	情報

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

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

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

無効または期限切れの資格情報
権限が不十分です
ネットワーク接続の問題
構成エラー

認証実装の詳細

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 のプロジェクト間で作業項目を検索する

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

貢献

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

スターの歴史

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

AI アシスタントが標準化されたプロトコルを通じて、プロジェクト、作業項目、リポジトリ、プルリクエスト、ブランチ、パイプラインなどの Azure DevOps リソースと対話できるようにするモデルコンテキストプロトコルサーバー。

Related Resources

Reddit Discussion about this server

Azure DevOps MCP Server