MCP Azure DevOps Server

MCP Azure DevOps Server

⚠️ 注意：官方服务已推出

请改用 Microsoft 官方 Azure DevOps MCP 服务：

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

此代码仓库已停止维护。Microsoft 官方服务提供更好的支持、持续维护和最新功能。

---

一个 Model Context Protocol（MCP）服务，可让 AI 助手与 Azure DevOps 服务交互。

概述

本项目实现了一个 Model Context Protocol（MCP）服务，可让 AI 助手（如 Claude）与 Azure DevOps 交互，为自然语言交互与 Azure DevOps REST API 之间搭建桥梁。

功能

目前已实现：

工作项管理

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

项目管理

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

计划中的功能：

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

入门指南

先决条件

• Python 3.10+
• 具有适当权限的 Azure DevOps 帐户
• 具有 Azure DevOps API 访问所需范围的个人访问令牌（PAT）

安装

# Clone the repository
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

# Install in development mode
uv pip install -e ".[dev]"

# Install from PyPi
pip install mcp-azure-devops

配置

在项目根目录中创建一个 .env 文件，并添加以下变量：

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

注意：请务必提供 Azure DevOps 组织的完整 URL。

运行服务

# Development mode with the MCP Inspector
mcp dev src/mcp_azure_devops/server.py

# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

使用示例

查询工作项

Show me all active bugs assigned to me in the current sprint

创建工作项

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to [email protected]

更新工作项

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

团队管理

Show me all the team members in the "Core Development" team in the "ProjectX" project

查看项目结构

List all projects in my organization and show me the iterations for the Development team

开发

本项目采用功能模块结构，每个模块实现特定的 Azure DevOps 功能：

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

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

贡献

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

许可证

本项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

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