🚀 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：通用工具和客户端初始化代码
📚 详细文档
如需了解更多信息，请访问项目文档。