MCP Azure Devops

🚀 MCP Azure DevOps サーバー

このプロジェクトは、AIアシスタントがAzure DevOpsサービスとやり取りできるようにする、モデルコンテキストプロトコル（MCP）サーバーを提供します。自然言語でのやり取りとAzure DevOps REST APIの間に架ける橋となります。

✨ 主な機能

現在実装されている機能

作業項目管理

• 作業項目の検索：WIQLクエリを使用して作業項目を検索します。
• 作業項目の詳細情報の取得：作業項目の完全な情報を表示します。
• 作業項目の作成：新しいタスク、バグ、ユーザーストーリーなどの作業項目を追加します。
• 作業項目の更新：既存の作業項目のフィールドと属性を変更します。
• コメントの追加：作業項目にコメントを投稿します。
• コメントの表示：作業項目のコメント履歴を取得します。
• 親子関係の設定：作業項目間の階層構造を設定します。

プロジェクト管理

• プロジェクトの取得：組織内のすべてのアクセス可能なプロジェクトを表示します。
• チームの取得：組織内のすべてのチームを一覧表示します。
• チームメンバーの表示：チームメンバーの情報を表示します。
• チームのエリアパスの取得：チームに割り当てられたエリアパスを取得します。
• チームのイテレーションの取得：チームのイテレーション/スプリント設定にアクセスします。

今後実装予定の機能

• パイプライン操作：パイプラインの状態をクエリし、新しいパイプライン実行をトリガーします。
• プルリクエストの処理：プルリクエストの作成、更新、レビューを行います。
• スプリント管理：スプリントとイテレーションの計画と管理を行います。
• ブランチポリシー管理：ブランチポリシーの設定と管理を行います。

🚀 クイックスタート

前提条件

• Python 3.10以上のバージョン
• 適切な権限を持つAzure DevOpsアカウント
• 必要なスコープを持つ個人用アクセストークン（PAT）

📦 インストール

# リポジトリをクローンする
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

# 開発モードでインストールする
pip install -e ".[dev]"

# PyPiからインストールする
pip install mcp-azure-devops

設定

プロジェクトのルートディレクトリに.envファイルを作成し、以下の変数を含めます。

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com または https://dev.azure.com/your-organisation

注意：組織の完全なURLを提供してください。

サーバーの起動

# 開発モードでMCP Inspectorと一緒に使用する
mcp dev src/mcp_azure_devops/server.py

# Claude Desktopにインストールする
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

💻 使用例

基本的な使用法

作業項目の検索

現在のスプリントで自分に割り当てられているすべてのアクティブなバグを表示

作業項目の作成

ProjectXプロジェクトに、「ユーザー認証の実装」というタイトルのユーザーストーリーを作成し、john.doe@example.comに割り当てる

作業項目の更新

バグ#1234の状態を「解決済み」に変更し、コメントで修正方法を説明する

チーム管理

ProjectXプロジェクトの「Core Development」チームのすべてのメンバー情報を表示

プロジェクト構造の表示

自分の組織内のすべてのプロジェクトを一覧表示し、Developmentチームのイテレーション設定を表示する

📚 ドキュメント

詳細な情報については、プロジェクトドキュメントを参照してください。