Azure DevOps MCP Server

关键词

azure devopsai助手devops自动化工作流集成上下文协议

项目简介

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 助手。

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

服务器信息

访问项目