项目简介

Azure DevOps MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在让 AI 助手能够以标准化的方式与 Azure DevOps API 进行交互。它充当 AI 模型和 Azure DevOps 之间的桥梁,使得 AI 助手可以通过自然语言安全地访问和管理 Azure DevOps 中的项目、工作项、代码仓库等资源,并执行常见的 DevOps 工作流程。

主要功能点

  • 资源访问与管理: 支持 AI 助手访问和管理 Azure DevOps 中的项目、工作项、代码仓库、拉取请求、分支和流水线等资源。
  • 工作项操作: 允许 AI 助手创建和更新 Azure DevOps 工作项。
  • 代码仓库操作: 支持 AI 助手创建分支和拉取请求。
  • DevOps 工作流自动化: 使 AI 助手能够通过自然语言执行常见的 DevOps 工作流程。
  • 安全认证: 提供多种安全认证方式,包括个人访问令牌 (PAT)、Azure 身份和 Azure CLI 登录。
  • 标准化协议: 基于 Model Context Protocol (MCP) 构建,提供与 AI 助手集成的标准化接口。

安装步骤

  1. 安装 Node.js: 确保你的系统已安装 Node.js (v16 或更高版本) 和 npm 或 yarn 包管理器。
  2. 安装 MCP Server: 可以使用 npm 或 npx 直接运行 Azure DevOps MCP Server。无需全局安装,使用 npx 即可运行。

服务器配置

MCP 服务器需要配置 Azure DevOps 组织 URL 和认证信息才能正常工作。以下是配置 MCP 服务器启动命令 (command) 及其参数 (args) 的 JSON 格式配置信息示例,用于 MCP 客户端 (如 Claude Desktop 或 Cursor AI) 连接到此 MCP 服务器。

Azure 身份验证 (推荐,需预先登录 Azure CLI):

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",  // 替换为你的 Azure DevOps 组织 URL
        "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",                   // 设置认证方式为 Azure 身份
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"             // 替换为你的默认 Azure DevOps 项目名称 (可选)
      }
    }
  }
}

个人访问令牌 (PAT) 身份验证:

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",  // 替换为你的 Azure DevOps 组织 URL
        "AZURE_DEVOPS_AUTH_METHOD": "pat",                             // 设置认证方式为 PAT
        "AZURE_DEVOPS_PAT": "<YOUR_PAT>",                            // 替换为你的 Azure DevOps 个人访问令牌
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"             // 替换为你的默认 Azure DevOps 项目名称 (可选)
      }
    }
  }
}

配置参数说明:

  • 'command': 运行 MCP 服务器的命令,这里使用 'npx' 直接运行 npm 包。
  • 'args': 传递给 'npx' 的参数,'-y @tiberriver256/mcp-server-azure-devops' 表示运行 '@tiberriver256/mcp-server-azure-devops' npm 包。
  • 'env': 环境变量配置,用于传递 Azure DevOps 组织 URL、认证方式和个人访问令牌等敏感信息。
    • 'AZURE_DEVOPS_ORG_URL': 必需,你的 Azure DevOps 组织 URL,例如 'https://dev.azure.com/your-organization'。
    • 'AZURE_DEVOPS_AUTH_METHOD': 可选,认证方式,可设置为 'pat' (个人访问令牌) 或 'azure-identity' (Azure 身份)。 默认为 'azure-identity'。
    • 'AZURE_DEVOPS_PAT': 当 'AZURE_DEVOPS_AUTH_METHOD' 设置为 'pat' 时必需,你的 Azure DevOps 个人访问令牌。
    • 'AZURE_DEVOPS_DEFAULT_PROJECT': 可选,默认 Azure DevOps 项目名称。如果未指定,则在某些操作中可能需要显式指定项目名称。

请根据你的实际 Azure DevOps 环境和选择的认证方式,修改上述 JSON 配置信息。

基本使用方法

  1. 启动 MCP 服务器: MCP 服务器会在后台运行,并通过标准输入/输出 (stdio) 与 MCP 客户端通信。无需手动启动,MCP 客户端会自动启动和连接服务器。
  2. 配置 MCP 客户端: 在你的 MCP 客户端 (如 Claude Desktop 或 Cursor AI) 中,添加上述 JSON 格式的服务器配置信息。
  3. 使用 AI 助手与 Azure DevOps 交互: 现在你可以使用 AI 助手的自然语言界面,通过配置的 MCP 服务器与 Azure DevOps 进行交互了。例如,你可以询问 AI 助手 "列出我的 Azure DevOps 项目" 或 "创建一个名为 'Bug' 的工作项,标题为 '无法登录',项目为 'your-project-name'" 等。AI 助手会将你的请求转换为 MCP 协议消息,发送给 MCP 服务器,服务器会调用 Azure DevOps API 执行操作,并将结果返回给 AI 助手。

具体可使用的工具和详细操作方法,请参考仓库文档。

信息

分类

开发者工具