MCP Azure DevOps Server

🚀 MCP Azure DevOps 服务器

MCP Azure DevOps 服务器实现了模型上下文协议（MCP），它能让 AI 助手与 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 监视器一起使用
mcp dev src/mcp_azure_devops/server.py

# 在 Claude Desktop 中安装
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps 助手"

✨ 主要特性

已实现功能

工作项管理

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

项目管理

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

计划实现功能

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

💻 使用示例

基础用法

查询工作项

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

创建工作项

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

更新工作项

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

团队管理

显示“Core Development”团队在 ProjectX 项目中的所有成员信息

查看项目结构

列出我的组织中的所有项目，并显示 Development 团队的迭代配置

📚 详细文档

该项目按功能模块进行开发，每个模块实现特定的 Azure DevOps 功能：

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

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

🤝 贡献

我们欢迎社区贡献！ 如果您有任何问题、建议或修复，请提交拉取请求或问题。 请在提交代码之前阅读我们的 贡献指南。

📄 许可证

该项目根据 MIT License 分发。

📞 联系方式

如有任何疑问，请联系项目维护人员：contact information。

感谢您对 MCP Azure DevOps 服务器的关注！ 我们期待您的反馈和贡献。