Azure DevOps (ADO)

Azure DevOps MCP Server

重要

我们建议使用远程 MCP 服务，而不是此本地服务。它无需安装，并且能率先获得新功能。

了解详情

此项目通过模型上下文协议（MCP）为 AI Agent 提供 Azure DevOps 访问能力。使用托管的远程服务可实现最简单的设置；如果需要 stdio 连接，也可以运行本地服务。

目录

1. 概述
2. 设计
3. 远程 MCP 服务（推荐）
4. 支持的工具
5. 本地 MCP 服务安装（可选）
6. 使用域（本地服务）
7. 项目和团队默认设置（本地服务）
8. 故障排除
9. 示例和最佳实践
10. 常见问题
11. 贡献

概述

Azure DevOps MCP Server 将 Azure DevOps 上下文提供给你的 Agent。可以尝试以下提示词：

• “列出我的 ADO 项目”
• “列出 ‘Contoso’ 的 ADO Builds”
• “列出 ‘Contoso’ 的 ADO Repos”
• “列出 ‘Contoso’ 的测试计划”
• “列出项目 ‘Contoso’ 的团队”
• “列出项目 ‘Contoso’ 的迭代”
• “列出我在项目 ‘Contoso’ 中的工作项”
• “列出项目 ‘Contoso’ 和团队 ‘Contoso Team’ 当前迭代中的工作项”
• “列出 ‘Contoso’ 项目中的所有 Wiki”
• “创建 Wiki 页面 ‘/Architecture/Overview’，内容为系统设计相关信息”
• “使用新的入职说明更新 Wiki 页面 ‘/Getting Started’”
• “从 Documentation Wiki 获取 Wiki 页面 ‘/API/Authentication’ 的内容”

设计

每个工具都负责一项专门的 Azure DevOps 任务。服务在 REST API 上提供轻量封装，而 AI Agent 负责更高层次的推理。

远程 MCP 服务（推荐）

完整说明请参阅远程 MCP 服务入门文档。

远程服务最终将取代本地服务。本地服务仍受支持，但后续开发将聚焦于远程服务。现有本地服务用户应开始规划迁移。

如果工具遇到问题、需要支持或有功能请求，可以使用远程 MCP 服务问题模板报告问题。在预览期间，我们将通过此存储库跟踪远程 MCP 服务问题。

快速开始

在项目中创建 .vscode/mcp.json 并添加以下配置。将 {organization} 替换为你的 Azure DevOps 组织名称。

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

如需了解更多选项，请参阅远程服务配置文档。

保存 .vscode/mcp.json 后，从 VS Code 的 MCP 视图启动服务，然后运行类似 List ADO projects 的提示词。

支持的工具

完整的远程工具列表请参阅可用工具文档。

完整的本地工具列表请参阅 TOOLSET.md。

本地 MCP 服务安装（可选）

重要

请先使用远程 MCP 服务。只有在你的场景明确需要本地 stdio 设置时，才使用本地 MCP 服务。

以下步骤使用 Visual Studio Code 和 GitHub Copilot。其他受支持的客户端（包括 Visual Studio 2022、Codex、Claude Code、Cursor、OpenCode 和 Kilo Code）的说明，请参阅入门指南。

前提条件

1. 安装 VS Code 或 VS Code Insiders。
2. 安装 Node.js 20 或更高版本。
3. 在 VS Code 中打开项目。

安装

从 npm 安装

1. 在项目中创建 .vscode/mcp.json。
2. 添加以下配置：

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}"]
    }
  }
}

3. 保存文件，然后从 VS Code 的 MCP 视图启动 ado 服务。
4. 打开 GitHub Copilot Chat 并切换到 Agent 模式。
5. 选择 Azure DevOps 工具，然后尝试输入类似 List ADO projects 的提示词。
6. 按提示使用有权访问所选 Azure DevOps 组织的 Microsoft 账户登录。

若要使用 nightly 版本，请在配置中将 @azure-devops/mcp 替换为 @azure-devops/mcp@next。

为了更好地选择工具，请在项目中添加 .github/copilot-instructions.md，并写入以下指令：

This project uses Azure DevOps. Always check whether the Azure DevOps MCP server has a tool relevant to the user's request.

使用域（本地服务）

本地服务包含许多工具。域可让你只加载所需的工具组，从而使工具列表更易于管理，并帮助客户端应对工具数量限制。可用的域包括 core、work、work-items、search、test-plans、repositories、wiki、pipelines 和 advanced-security。

在服务参数中添加 -d，后面跟上域。例如，以下配置仅加载与工作项相关的工具：

{
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "-d", "core", "work", "work-items"]
    }
  }
}

务必包含 core，以便 Agent 获取项目信息。

如果省略 -d，服务将加载所有域。

项目和团队默认值（本地服务）

在 .vscode/mcp.json 中设置默认的 Azure DevOps 项目和团队值，以便工具跳过选择提示。

.vscode/mcp.json 示例

{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "{organization}", "--authentication", "azcli"],
      "env": {
        "ado_mcp_project": "Contoso",
        "ado_mcp_team": "Fabrikam Team"
      }
    }
  }
}

故障排除

如需了解常见问题和日志记录方面的帮助，请参阅故障排除指南。

示例

请参阅示例，了解提示词示例。

常见问题

如需了解 Azure DevOps MCP Server 常见问题的解答，请参阅常见问题。

贡献

欢迎贡献。在预览期间，请针对错误、功能改进或文档改进提交问题。

有关以下内容，请参阅贡献指南：

• 开发环境设置
• 添加新工具
• 代码风格和测试
• 拉取请求流程

创建拉取请求前，请阅读贡献指南。

行为准则

本项目遵循 Microsoft 开源行为准则。 如有疑问，请参阅 FAQ 或联系 [email protected]。

荣誉榜

感谢所有让这个项目变得出色的贡献者！❤️

使用 contrib.rocks 生成

许可证

根据 MIT 许可证授权。

---

商标：本项目可能包含 Microsoft 或第三方的商标或徽标。使用 Microsoft 商标或徽标须遵循 Microsoft 商标和品牌指南。第三方商标受其各自政策约束。