MCP Azure DevOps Server

⚠️ 通知：官方服务器可用

请改用微软官方的 Azure DevOps MCP 服务器：

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

本仓库不再维护。微软官方服务器提供更好的支持、持续维护以及最新特性。

---

一个模型上下文协议（MCP）服务器，使AI助手能够与Azure DevOps服务进行交互。

概述

该项目实现了一个模型上下文协议（MCP）服务器，允许AI助手（如Claude）与Azure DevOps进行交互，提供自然语言交互与Azure DevOps REST API之间的桥梁。

功能

当前已实现的功能：

工作项管理

• 查询工作项：使用WIQL查询搜索工作项
• 获取工作项详情：查看完整的工作项信息
• 创建工作项：添加新的任务、错误、用户故事和其他类型的工作项
• 更新工作项：修改现有工作项的字段和属性
• 添加评论：在工作项上发布评论
• 查看评论：检索工作项的评论历史
• 父子关系：建立工作项之间的层级关系

项目管理

• 获取项目：查看组织中所有可访问的项目
• 获取团队：列出组织中的所有团队
• 团队成员：查看团队成员信息
• 团队区域路径：检索分配给团队的区域路径
• 团队迭代：访问团队迭代/冲刺配置

计划实现的功能：

• 管道操作：查询管道状态并触发新的管道运行
• 拉取请求处理：创建、更新和审查拉取请求
• 冲刺管理：规划和管理冲刺和迭代
• 分支策略管理：配置和管理分支策略

快速开始

预备条件

• Python 3.10+
• 具有适当权限的Azure DevOps账户
• 具有访问Azure DevOps API所需范围的个人访问令牌（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

注意：确保提供完整的Azure DevOps组织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"

使用示例

查询工作项

显示分配给我且在当前冲刺中的所有活动错误

创建工作项

在ProjectX中创建一个用户故事，标题为“实现用户认证”，并将其分配给john.doe@example.com

更新工作项

将错误#1234的状态更改为“已解决”，并添加解释修复情况的评论

团队管理

显示ProjectX项目中“核心开发”团队的所有成员

查看项目结构

列出我组织中的所有项目，并显示开发团队的迭代

开发

项目按功能模块结构化，每个模块实现特定的Azure DevOps能力：

• features/work_items：工作项管理功能
• features/projects：项目管理能力
• features/teams：团队管理功能
• utils：通用工具和客户端初始化

有关更多开发信息，请参阅CLAUDE.md文件。

贡献

欢迎贡献！请随意提交拉取请求。

许可证

本项目根据MIT许可证授权 - 详情见LICENSE文件。

致谢

• 使用MCP Python SDK构建
• 使用Azure DevOps Python API