使用说明

项目简介

该项目实现了 MCP 协议服务器,允许 AI 助手通过自然语言与 Azure DevOps 进行交互,从而管理工作项、操作管道、处理拉取请求等。通过此服务器,AI 助手可以连接到 Azure DevOps,帮助用户自动化工作流程,提高开发效率。

主要功能点

  • 工作项管理:支持创建、更新、查询 Azure DevOps 中的工作项,例如 Bug、任务、用户故事等。
  • 管道操作:可以查询 Azure DevOps 管道的构建状态,触发新的管道运行,帮助用户监控和管理 CI/CD 流程。
  • 拉取请求处理:支持创建、更新和审查拉取请求,方便团队进行代码协作和评审。
  • Sprint 管理:提供 Sprint 和迭代的管理功能,辅助团队进行敏捷开发计划和跟踪。
  • 分支策略管理:允许配置和管理 Azure DevOps 仓库的分支策略,确保代码质量和合规性。

安装步骤

  1. 克隆代码仓库到本地:
    git clone https://github.com/Vortiago/mcp-azure-devops.git
    cd mcp-azure-devops
  2. 安装 Python 依赖(推荐使用开发模式安装,方便本地调试):
    pip install -e ".[dev]"

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到此 MCP 服务器:

{
  "serverName": "Azure DevOps Assistant",
  "command": "mcp",
  "args": ["dev", "src/mcp_azure_devops/server.py"]
}

配置信息说明:

  • 'serverName': 自定义的服务器名称,用于在 MCP 客户端中识别和显示此服务器。
  • 'command': 启动 MCP 服务器的命令。这里假设您已安装 'mcp' 命令行工具,并使用 'dev' 命令以开发模式运行服务器。
  • 'args': 传递给 'mcp dev' 命令的参数列表。'src/mcp_azure_devops/server.py' 指定了服务器入口点脚本。'dev' 模式方便开发调试,正式部署时可能需要调整。

注意

  • 确保已安装 MCP 客户端,例如 Claude Desktop 或其他支持 MCP 协议的应用。
  • 运行服务器前,请配置环境变量 '.env' 文件,填入您的 Azure DevOps Personal Access Token (PAT) 和组织名称。

基本使用方法

  1. 启动 MCP 服务器(根据安装步骤和服务器配置进行启动)。
  2. 在 MCP 客户端中添加并连接到 "Azure DevOps Assistant" 服务器。
  3. 使用自然语言指令与 AI 助手交互,例如:
    • "Show me all active bugs assigned to me in the current sprint" (显示当前 Sprint 分配给我的所有活跃 Bug)
    • "Create a pull request from feature/new-login-page to main with the title 'Implement new login page'" (创建一个从 feature/new-login-page 到 main 分支的拉取请求,标题为 'Implement new login page')
    • "What's the status of the latest build for the main branch?" (主分支最新构建的状态是什么?) 更多使用示例请参考仓库的 README 文档。

信息

分类

开发者工具