MCP Azure DevOps Server

🚀 MCP Azure DevOps サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）を実装したサーバーで、AIアシスタント（Claudeなど）がAzure DevOpsサービスとやり取りできるようにします。自然言語インタラクションとAzure DevOps REST APIの橋渡しとなります。

🚀 クイックスタート

前提条件

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

インストール

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

# 開発モードでインストールする
uv 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モニターとともに使用する
mcp dev src/mcp_azure_devops/server.py

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

✨ 主な機能

現在実装されている機能

ワークアイテム管理

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

プロジェクト管理

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

今後実装予定の機能

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

💻 使用例

基本的な使用法

ワークアイテムの検索

現在のスプリントで自分に割り当てられたすべてのアクティブなエラーを表示

ワークアイテムの作成

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

ワークアイテムの更新

エラー #1234の状態を「解決済み」に変更し、修正方法を説明するコメントを追加する

チーム管理

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

プロジェクト構造の表示

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

📚 ドキュメント

このプロジェクトは機能モジュールごとに開発されており、各モジュールは特定のAzure DevOps機能を実装しています。

• features/work_items：ワークアイテム管理機能
• features/projects：プロジェクト管理機能
• features/teams：チーム管理機能
• utils：共通ユーティリティとクライアントの初期化

詳細な開発情報については、CLAUDE.md ファイルを参照してください。

🤝 コントリビューション

コミュニティからのコントリビューションを歓迎します！ 何か問題、提案、または修正がある場合は、プルリクエストまたはイシューを提出してください。 コードを提出する前に、コントリビューションガイド を読んでください。

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。

📞 連絡先

何か質問がある場合は、プロジェクトのメンテナに連絡してください：連絡先情報。

MCP Azure DevOpsサーバーにご関心いただき、ありがとうございます！ フィードバックとコントリビューションをお待ちしています。