MCP Azure Devops

🚀 MCP Azure DevOps 服務器

一個模型上下文協議（MCP）服務器，使AI助手能夠與Azure DevOps服務交互，為自然語言交互與Azure DevOps REST API搭建橋樑。

🚀 快速開始

該項目實現了一個模型上下文協議（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 Inspector一起使用
mcp dev src/mcp_azure_devops/server.py

# 在Claude Desktop中安裝
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

✨ 主要特性

當前已實現的功能

工作項管理

• 查詢工作項：使用WIQL查詢搜索工作項
• 獲取工作項詳細信息：查看完整的工作項信息
• 創建工作項：添加新任務、錯誤、用戶故事和其他類型的工作項
• 更新工作項：修改現有工作項的字段和屬性
• 添加評論：在工作項上發佈評論
• 查看評論：檢索工作項的評論歷史記錄
• 父子關係：建立工作項之間的層次結構

項目管理

• 獲取項目：查看組織中的所有可訪問項目
• 獲取團隊：列出組織中的所有團隊
• 團隊成員：查看團隊成員信息
• 團隊區域路徑：檢索分配給團隊的區域路徑
• 團隊迭代：訪問團隊的迭代/衝刺配置

計劃實現的功能

• 管道操作：查詢管道狀態和觸發新的管道運行
• 拉取請求處理：創建、更新和審查拉取請求
• 衝刺管理：規劃和管理衝刺和迭代
• 分支策略管理：配置和管理分支策略

💻 使用示例

基礎用法

查詢工作項

顯示當前衝刺中分配給我的所有活動錯誤

創建工作項

在ProjectX項目中創建一個用戶故事，標題為“實現用戶身份驗證”，並將其分配給john.doe@example.com

更新工作項

將錯誤#1234的狀態更改為“已解決”，並在評論中說明修復方法

團隊管理

顯示“Core Development”團隊在ProjectX項目中的所有成員信息

查看項目結構

列出我組織中的所有項目，並顯示Development團隊的迭代配置

🔧 技術細節

該項目按功能模塊進行開發，每個模塊實現特定的Azure DevOps功能：

• features/work_items：工作項管理功能
• features/projects：項目管理功能
• features/teams：團隊管理功能
• utils：通用工具和客戶端初始化代碼

📚 詳細文檔

如需瞭解更多信息，請訪問項目文檔。