MCP Azure DevOps Server

一个模型上下文协议 (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 文件。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

致谢

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