MCP Azure DevOps Server

🚀 MCP Azure DevOps 服務器

本項目實現了一個模型上下文協議（MCP）服務器，它作為自然語言交互與 Azure DevOps REST API 之間的橋樑，讓 AI 助手（如 Claude）能夠與 Azure DevOps 服務進行交互。

🚀 快速開始

先決條件

• 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 的狀態更改為“已解決”，並添加評論解釋修復方法

團隊管理

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

查看項目結構

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

📚 詳細文檔

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

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

有關更多開發信息，請參閱 CLAUDE.md 文件。

🤝 貢獻

我們歡迎社區貢獻！ 如果您有任何問題、建議或修復，請提交拉取請求或問題。 請在提交代碼之前閱讀我們的 貢獻指南。

📄 許可證

該項目根據 MIT License 分發。

📞 聯繫方式

如有任何疑問，請聯繫項目維護人員：contact information。

感謝您對 MCP Azure DevOps 服務器的關注！ 我們期待您的反饋和貢獻。