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：通用工具和客户端初始化代码

📚 详细文档

如需了解更多信息，请访问项目文档。