项目简介
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 助手集成的标准化接口。
安装步骤
- 安装 Node.js: 确保你的系统已安装 Node.js (v16 或更高版本) 和 npm 或 yarn 包管理器。
- 安装 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 配置信息。
基本使用方法
- 启动 MCP 服务器: MCP 服务器会在后台运行,并通过标准输入/输出 (stdio) 与 MCP 客户端通信。无需手动启动,MCP 客户端会自动启动和连接服务器。
- 配置 MCP 客户端: 在你的 MCP 客户端 (如 Claude Desktop 或 Cursor AI) 中,添加上述 JSON 格式的服务器配置信息。
- 使用 AI 助手与 Azure DevOps 交互: 现在你可以使用 AI 助手的自然语言界面,通过配置的 MCP 服务器与 Azure DevOps 进行交互了。例如,你可以询问 AI 助手 "列出我的 Azure DevOps 项目" 或 "创建一个名为 'Bug' 的工作项,标题为 '无法登录',项目为 'your-project-name'" 等。AI 助手会将你的请求转换为 MCP 协议消息,发送给 MCP 服务器,服务器会调用 Azure DevOps API 执行操作,并将结果返回给 AI 助手。
具体可使用的工具和详细操作方法,请参考仓库文档。
信息
分类
开发者工具