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 にログインしていることを確認してから、以下を追加します。
個人アクセストークン(PAT)認証
詳細な構成手順とその他の認証オプションについては、 『認証ガイド』を参照してください。
認証方法
このサーバーは、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 のプロジェクト間で作業項目を検索する
パイプラインツール
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 をご覧ください。
スターの歴史
ライセンス
マサチューセッツ工科大学
You must be authenticated.
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.
Tools
AI アシスタントが標準化されたプロトコルを通じて、プロジェクト、作業項目、リポジトリ、プル リクエスト、ブランチ、パイプラインなどの Azure DevOps リソースと対話できるようにするモデル コンテキスト プロトコル サーバー。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standardized interface for communicating with Azure DevOpsLast updated -9619TypeScriptMIT License
- -securityFlicense-qualityA reference server implementation for the Model Context Protocol that enables AI assistants to interact with Azure DevOps resources and perform operations such as project management, work item tracking, repository operations, and code search programmatically.Last updated -3TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Azure DevOps services, allowing users to query work items with plans to support creating/updating items, managing pipelines, handling pull requests, and administering sprints and branch policies.Last updated -950PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server for querying and analyzing Azure resources at scale using Azure Resource Graph, enabling AI assistants to explore and monitor Azure infrastructure.Last updated -15TypeScriptMIT License
Appeared in Searches
- A server for information about Jenkins (automation server)
- A system for monitoring and operating terminals
- Azure DevOps and Azure Repos Integration for Developer Workflows
- A platform for hosting and collaborating on software projects
- A tool or assistant to review and suggest changes for GitHub pull requests