Azure DevOps MCP Server

官方

把 Azure DevOps 的项目、工作项、代码仓库和管道能力接入你的 AI 代理

分类: 开发工具第 60 / 438
Stars: ★ 2.1k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 5 天前

64FMRS · C

微软官方维护的 Azure DevOps MCP 服务器,提供远程(推荐)和本地两种接入方式,覆盖项目、工作项、仓库、Wiki、测试计划和管道等核心场景;需要 Microsoft 账号登录且工具集较大,建议按需通过工具域裁剪,并留意近期工具重命名带来的兼容性影响。

最强项 · 维护活跃度 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

12/20

维护活跃度

16/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: 静态证据中未提供任何测试文件、CI 工作流或源代码,无法验证 MCP 初始化/工具列表握手是否可复现,按静态校准规则可靠性不得超过12分。更值得注意的是 manifest 中 npm 包标识符为 '@microsoft/azure-devops',而 README 中所有安装示例均使用 'npx -y @azure-devops/mcp'/'@azure-devops/[email protected]',二者不一致,说明 server.json 清单可能已过期或不准确,这是声明行为与实际行为不符的直接证据。README 顶部还有关于'工具整合与重命名'的重大变更警告,暗示近期存在破坏性变更历史,进一步降低可靠性判断的信心。综合给7分。
安全与权限 12/20: 远程服务器通过浏览器 Microsoft 账号 OAuth 登录,本地服务器支持 azcli 等认证方式,安装示例中未见硬编码密钥或明文令牌,不触及红线。但该服务器覆盖面很广(work-items、repositories、wiki、pipelines、advanced-security 等域),包含创建/更新 wiki 页面等写操作,以及 'advanced-security' 域可能涉及安全扫描等敏感数据,而现有文档未说明这些写操作或高敏感域是否有二次确认、最小权限范围限定或数据边界披露机制,仅通过 Domains 做粗粒度的工具集筛选而非按读写权限区分。这些主要风险可见但缓解措施披露不完整,故评为12分。
维护活跃度 16/20: 仓库由 Microsoft 官方组织维护,采用 MIT 许可证,当前 1942 星、仅12个未关闭 issue,说明问题响应较及时;README 提及可通过 nightly build(@next)与版本回退(如固定到 2.8.1)进行版本管理,表明版本发布节奏活跃,且存在 CONTRIBUTING.md 与 Code of Conduct 说明治理流程。但提供的证据中未见明确的 SECURITY.md 或安全漏洞上报渠道说明,故未给满分,评为16分。
文档质量 15/20: 文档体系分层清晰,包含 TOOLSET.md、GETTINGSTARTED.md、TROUBLESHOOTING.md、EXAMPLES.md、HOWTO.md、FAQ.md 等多个专题文档,并提供多客户端(VS Code、Visual Studio 2022、Codex、Claude Code、Cursor 等)配置示例和 GIF 演示,覆盖面较好。但文档未充分披露 API 调用限制、成本或速率限制等信息,且存在 manifest 包名与 README 安装命令不一致的问题,构成隐藏的假设/矛盾,故不能给满分,评为15分。
安装易用性 14/20: 远程服务器只需在 mcp.json 中填入一个 URL 即可使用,几乎零安装门槛;本地服务器通过 npx 一行命令加输入参数即可运行,并提供 Domains、项目/团队默认值等可选精细化配置,同时有清晰的客户端配置示例和分步说明。但由于是纯静态审查,没有可验证的执行证据(无 CI/无自动化测试证明这些步骤真实可运行),按静态校准规则安装易用性不得超过15分,故评为14分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

已经在使用 Azure DevOps 管理工作项、代码仓库、Wiki 或管道的团队
使用 VS Code + GitHub Copilot(或其他支持 MCP 的客户端)的开发者
希望通过自然语言查询/操作 Azure DevOps 而无需手写 REST API 调用的场景

不适合谁

不使用 Azure DevOps、仅用 GitHub 或其他项目管理工具的团队
需要开箱即用、无需选择工具域或登录授权的极简服务器场景
对预览阶段功能稳定性要求很高、无法容忍工具改名等破坏性变更的场景(README 提到近期发生过工具整体重命名)

所需权限

需要用与目标 Azure DevOps 组织匹配的 Microsoft 账号完成 OAuth 浏览器登录(远程与本地均适用)
本地服务器还支持通过 --authentication azcli 等方式进行身份验证
需要提供 Azure DevOps 组织标识符(organization,如 'contoso')
本地模式下可通过环境变量设置默认 project 和 team 以跳过选择提示

风险与副作用

工具覆盖面广,可能允许修改 Wiki 页面、工作项等组织数据,需确认登录账号权限范围合适
远程服务器处于预览阶段,功能和问题跟踪仍在完善中
近期发生过工具整体重命名(consolidation),可能对已有 Agent/技能造成破坏性变更,需按文档确认新工具名或临时锁定旧版本
本地服务器需要 Node.js 20+ 环境,版本不符会导致安装或运行失败

安装接入

准备工作

运行环境：Node.js 20+ · 远程托管（无需本地环境）

推荐方式(远程,免安装):在 .vscode/mcp.json 中添加类型为 http、地址为 https://mcp.dev.azure.com/{organization} 的服务器配置,在 VS Code 的 MCP 视图中启动即可,首次调用工具时会弹出浏览器要求用匹配组织的 Microsoft 账号登录。
可选方式(本地 stdio):需先安装 Node.js 20+,在 .vscode/mcp.json 中配置 command 为 npx、args 为 ["-y", "@azure-devops/mcp", "${input:ado_org}"] 的 stdio 服务器,保存后在 VS Code 中启动,并在 Agent 模式下选择所需工具;可用 -d 参数(如 "-d", "core", "work", "work-items")限定加载的工具域,建议始终启用 core 域。

MCP 配置 · JSON

{
  "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}"]
    }
  }
}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add ado -- npx -y @azure-devops/mcp '${input:ado_org}'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

保存 .vscode/mcp. 并启动服务器后，在 Copilot Chat（Agent Mode）中运行提示“List ADO projects”；首次执行 ADO 工具时会打开浏览器要求使用 Microsoft 账户登录，能返回项目列表即证明连接成功。

常见排障

确认 mcp.json 中的组织标识符(organization)拼写正确且与登录账号所属组织一致
首次使用工具时留意浏览器弹出的登录窗口,确保使用匹配所选组织的 Microsoft 账号登录
本地模式下确认已启用所需的工具域(-d 参数),核心信息依赖 core 域
若遇到工具找不到或行为异常,检查是否受近期工具重命名影响,参考 docs/TOOLSET.md 或临时锁定 @azure-devops/[email protected]
查阅仓库 docs/TROUBLESHOOTING.md 和 docs/FAQ.md 获取常见问题排查步骤

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 ADO 项目
列出 'Contoso' 的 ADO 构建
列出项目 'Contoso' 当前迭代中的工作项
获取 Documentation wiki 中 '/API/Authentication' 页面的内容

使用场景

列出我的 Azure DevOps 项目

列出某项目的构建(Builds)、代码仓库或测试计划

列出某项目的团队和迭代

查看当前迭代下我的或团队的工作项

列出、创建或更新项目 Wiki 页面并获取其内容

支持客户端

VS Code

依据项目文档列出，未经本站实测。

详细介绍

由 Microsoft 官方维护的 MCP 服务器,将 AI 代理连接到 Azure DevOps,可访问组织、项目、看板/工作项、代码仓库、Wiki、测试计划和管道。推荐使用无需安装的远程 streamable-HTTP 端点(mcp.dev.azure.com/{organization}),也提供可选的本地 Node.js/npm stdio 服务器,并可通过“域”(domains)按需加载工具分组,如 core、work、work-items、search、test-plans、repositories、wiki、pipelines、advanced-security。