⭐ Azure DevOps MCP 服务器

[!重要] Azure DevOps 远程 MCP 服务器现已面向所有组织开放公共预览。我们建议您今后迁移到远程 MCP 服务器。

了解更多

这个 TypeScript 项目为 Azure DevOps 提供了一个本地的 MCP 服务器，使您能够直接从代码编辑器中执行各种 Azure DevOps 任务。

📄 目录

1. 📺 概述
2. 🏆 期望
3. 🚀 远程 MCP 服务器
4. ⚙️ 支持的工具
5. 🔌 安装与入门
6. 🌏 使用域
7. 📝 故障排除
8. 🎩 示例与最佳实践
9. 🙋‍♀️ 常见问题
10. 📌 贡献

📺 概述

Azure DevOps MCP 服务器将 Azure DevOps 的上下文引入到您的代理中。您可以尝试以下提示：

• “列出我的 ADO 项目”
• “列出‘Contoso’的 ADO 构建”
• “列出‘Contoso’的 ADO 存储库”
• “列出‘Contoso’的测试计划”
• “列出‘Contoso’项目的团队”
• “列出‘Contoso’项目的迭代”
• “列出我在‘Contoso’项目中的工作项”
• “列出‘Contoso’项目和‘Contoso 团队’当前迭代中的工作项”
• “列出‘Contoso’项目中的所有维基”
• “创建一个名为‘/Architecture/Overview’的维基页面，内容关于系统设计”
• “更新‘/Getting Started’维基页面，加入新的入职说明”
• “从文档维基中获取‘/API/Authentication’维基页面的内容”

🏆 期望

Azure DevOps MCP 服务器由简洁、简单、专注且易于使用的工具构建而成，每个工具都针对特定场景设计。我们有意避免那些试图做太多事情的复杂工具。我们的目标是在 REST API 上提供一个轻量级的抽象层，使数据访问变得直接明了，并让语言模型负责处理复杂的推理。

🚀 远程 MCP 服务器

Azure DevOps 远程 MCP 服务器现已在公共预览版中可用。

随着时间的推移，远程 MCP 服务器将取代此本地 MCP 服务器。目前我们仍将继续支持本地服务器，但未来的投入将主要集中在远程体验上。

我们鼓励所有使用本地 MCP 服务器的用户开始迁移到远程 MCP 服务器。

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

[!警告] 内部 Microsoft 用户请勿在此仓库中创建问题。请改用专门的 Teams 频道。

有关如何开始使用远程 MCP 服务器的说明，请参阅入门文档。

⚙️ 支持的工具

完整列表请参阅TOOLSET.md。

🔌 安装与入门

为了获得最佳体验，建议使用 Visual Studio Code 和 GitHub Copilot。有关如何将我们的 MCP 服务器与其他工具（如 Visual Studio 2022、Claude Code、Cursor、Opencode 和 Kilocode）一起使用的说明，请参阅入门文档。

先决条件

1. 安装 VS Code 或 VS Code Insiders
2. 安装 Node.js 20+
3. 在一个空文件夹中打开 VS Code

安装

🧨 从公共源安装（推荐）

对于所有 Visual Studio Code 用户来说，这是最简单的安装方法。

🎥 观看这段快速入门视频，两分钟内即可上手！

步骤

在您的项目中，添加一个 .vscode\mcp.json 文件，内容如下：

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps 组织名称（例如‘contoso’）"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
    }
  }
}

🔥 为了及时获取最新功能，您可以使用我们的夜间构建版本。只需将 mcp.json 配置更新为使用 @azure-devops/mcp@next。以下是更新后的示例：

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps 组织名称（例如‘contoso’）"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp@next", "${input:ado_org}"]
    }
  }
}

保存文件后，点击“开始”。

在聊天中，切换到代理模式。

点击“选择工具”，并选择可用的工具。

打开 GitHub Copilot Chat，尝试输入类似“列出 ADO 项目”的提示。首次执行 ADO 工具时，浏览器会弹出窗口，要求您使用 Microsoft 帐户登录。请确保您使用的凭据与所选的 Azure DevOps 组织匹配。

💥 我们强烈建议在您的项目中创建一个 .github\copilot-instructions.md 文件。这将提升您使用 Azure DevOps MCP 服务器与 GitHub Copilot Chat 的体验。 您可以在 Copilot 指令文件中简单地写入：“该项目使用 Azure DevOps。请务必检查 Azure DevOps MCP 服务器是否有与用户请求相关的工具。”

有关如何将我们的 MCP 服务器与其他工具（如 Visual Studio 2022、Claude Code 和 Cursor）一起使用的说明，请参阅入门文档。

🌏 使用域

Azure DevOps 暴露了庞大的功能范围。因此，我们的 Azure DevOps MCP 服务器包含许多工具。为了使工具集易于管理、避免混淆模型，并遵守客户端对加载工具数量的限制，可以使用域来仅加载您需要的部分。域是相关工具的命名组（例如：core、work、work-items、repositories、wiki）。在 mcp.json 中的服务器参数中添加 -d 参数和域名称，即可列出要启用的域。

例如，使用 "-d", "core", "work", "work-items" 只加载与工作项相关的工具（见下方示例）。

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps 组织名称（例如 'contoso'）"
    }
  ],
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "-d", "core", "work", "work-items"]
    }
  }
}

可用的域包括：core、work、work-items、search、test-plans、repositories、wiki、pipelines、advanced-security。

我们建议始终启用 core 工具，以便您可以获取项目级别的信息。

默认情况下会加载所有域

📝 故障排除

有关常见问题和日志记录的帮助，请参阅故障排除指南。

🎩 示例与最佳实践

请在我们的示例文档中探索示例提示。

有关提升您使用 MCP 服务器体验的最佳实践和技巧，请参阅操作指南。

🙋‍♀️ 常见问题解答

有关 Azure DevOps MCP 服务器常见问题的答案，请参阅常见问题解答。

📌 贡献

我们欢迎您的贡献！在预览期间，请提交关于错误、功能增强或文档改进的问题。

请参阅我们的贡献指南，了解：

• 🛠️ 开发环境设置
• ✨ 添加新工具
• 📝 代码风格与测试
• 🔄 拉取请求流程

⚠️ 请在创建拉取请求之前阅读贡献指南。

🤝 行为准则

本项目遵循微软开源行为准则。 如有疑问，请参阅常见问题解答或联系 open@microsoft.com。

📈 项目统计

🏆 名人堂

感谢所有让本项目如此出色的贡献者！❤️

由 contrib.rocks 生成

许可证

根据MIT 许可证授权。

---

商标：本项目可能包含微软或第三方的商标或标识。使用微软商标或标识时，必须遵守微软商标与品牌指南。第三方商标适用其各自的政策。

Azure DevOps MCP Server 快速上手指南

本指南帮助中国开发者快速在本地编辑器中集成 Azure DevOps 能力，通过自然语言直接管理项目、构建、仓库和工作项。

重要提示：微软已推出 Remote MCP Server（远程模式）并处于公共预览阶段，未来将逐步取代本地服务器。建议新用户优先评估远程方案，但本指南仍涵盖当前可用的本地部署方法。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• 代码编辑器：推荐安装 Visual Studio Code 或 VS Code Insiders
• 运行环境：安装 Node.js 版本 20 或更高
• 账号权限：拥有有效的 Microsoft 账号及对应的 Azure DevOps 组织访问权限
• 工作目录：在 VS Code 中打开一个空文件夹作为项目根目录

安装步骤

推荐使用公共源进行安装，这是最简便的方式。

1. 在项目根目录下创建 .vscode 文件夹。
2. 在该文件夹内新建 mcp.json 文件。
3. 将以下内容复制到 mcp.json 中（请将 contoso 替换为您实际的 Azure DevOps 组织名称）：

{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
    }
  }
}

4. 保存文件后，VS Code 会提示启动服务器，点击 Start。
5. 在 GitHub Copilot 聊天窗口中，切换到 Agent Mode（代理模式）。
6. 点击 "Select Tools" 并勾选已加载的 Azure DevOps 工具。

提示：若需体验最新功能，可将 args 中的包名改为 @azure-devops/mcp@next 以使用夜间构建版。

基本使用

配置完成后，您可以在 GitHub Copilot Chat 中直接使用自然语言与 Azure DevOps 交互。

首次使用验证： 输入以下指令，浏览器将弹出登录窗口，请使用与您选择的 Azure DevOps 组织匹配的 Microsoft 账号登录。

List ADO projects

常用操作示例：

• 查询构建记录： List ADO Builds for 'Contoso'
• 查看工作项： List my work items for project 'Contoso'
• 管理 Wiki 文档： Create a wiki page '/Architecture/Overview' with content about system design
• 优化体验建议： 建议在项目中创建 .github/copilot-instructions.md 文件，并写入以下内容，以提升 AI 对工具的调用准确率：

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

进阶技巧（按需加载工具域）： 为避免加载过多工具导致上下文混乱，您可以在 mcp.json 的 args 中添加 -d 参数来指定只加载特定的功能域（如 core, work-items, pipelines 等）。默认情况下所有域都会加载。

"args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "-d", "core", "work", "work-items"]