article
README
🚀 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 服务器的关注! 我们期待您的反馈和贡献。
微信扫一扫