MCP Azure DevOps Server

MCP Azure DevOps Server

⚠️ お知らせ：公式サーバーが公開されています

代わりに、Microsoft 公式の Azure DevOps MCP サーバーをご利用ください：

https://github.com/microsoft/azure-devops-mcp

このリポジトリはメンテナンスされていません。Microsoft 公式サーバーでは、より充実したサポート、継続的なメンテナンス、最新の機能が提供されています。

---

AI アシスタントが Azure DevOps サービスを利用できるようにする Model Context Protocol（MCP）サーバーです。

概要

このプロジェクトでは、AI アシスタント（Claude など）が Azure DevOps を利用できる Model Context Protocol（MCP）サーバーを実装しています。自然言語でのやり取りと Azure DevOps REST API をつなぐ役割を果たします。

機能

現在実装されている機能：

作業項目の管理

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

プロジェクト管理

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

今後実装予定の機能：

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

はじめに

前提条件

• Python 3.10+
• 適切な権限を持つ Azure DevOps アカウント
• Azure DevOps API へのアクセスに必要なスコープを持つ個人用アクセストークン（PAT）

インストール

# Clone the repository
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

# Install in development mode
uv pip install -e ".[dev]"

# Install from PyPi
pip install mcp-azure-devops

設定

プロジェクトのルートに、次の変数を含む .env ファイルを作成します：

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

注：Azure DevOps 組織の完全な URL を指定してください。

サーバーの実行

# Development mode with the MCP Inspector
mcp dev src/mcp_azure_devops/server.py

# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

使用例

作業項目の検索

Show me all active bugs assigned to me in the current sprint

作業項目の作成

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to [email protected]

作業項目の更新

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

チーム管理

Show me all the team members in the "Core Development" team in the "ProjectX" project

プロジェクト構成の表示

List all projects in my organization and show me the iterations for the Development team

開発

このプロジェクトは機能ごとのモジュールで構成され、それぞれが Azure DevOps の特定の機能を実装しています：

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

開発について詳しくは、CLAUDE.md ファイルをご覧ください。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• MCP Python SDK を使用して構築
• Azure DevOps Python API を使用