Azure DevOps MCP Server
让 AI 智能体通过 MCP 直接读写 Azure DevOps 的项目、工作项、仓库、流水线与 Wiki。
- Star 数
- ★ 2.1k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code（部分支持）
- 开始前需要
- 典型场景
- 使用 VS Code 与 GitHub Copilot Agent 模式的开发者，希望在聊天中直接查询自己有哪些 ADO 工作项，而不切换浏览器。
- 主要局限
- 深度绑定 Azure DevOps 与微软账户体系，其他代码托管平台的团队无法直接使用。
- 源码审查
- 61/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Azure DevOps MCP Server 是微软开源的 Model Context Protocol 服务器，为 AI 智能体提供访问 Azure DevOps 的统一入口。它有两种运行形态：推荐的远程托管服务器（https://mcp.dev.azure.com/{organization}，HTTP 类型，无需安装）和可选的本地服务器（通过 npx @azure-devops/mcp 以 stdio 方式运行）。每个工具只负责一个聚焦的 Azure DevOps 任务，服务器本身是对 REST API 的薄封装，复杂推理交由智能体完成。项目以 MIT 许可证发布，并说明远程服务器最终将取代本地服务器，新增功能优先在远程版本推出。文档覆盖 VS Code、Visual Studio 2022、Codex、Claude Code、Cursor、OpenCode、Kilo Code 等客户端。
服务器把 Azure DevOps 的 REST API 封装成一组 MCP 工具，供智能体在对话中调用：列出 ADO 项目、列出指定项目（如 Contoso）的 Builds、Repos、test plans、teams、iterations，查询当前迭代或指定项目/团队下的工作项，列出项目中的所有 Wiki，创建、更新和读取 Wiki 页面（如 '/Architecture/Overview'）。本地版本支持通过 -d 参数按域加载工具，可用域包括 core、work、work-items、search、test-plans、repositories、wiki、pipelines、advanced-security，并可设置 ado_mcp_project 与 ado_mcp_team 环境变量作为默认项目和团队。工具调用结果返回给智能体，由智能体组织成最终回答或操作建议。
- 使用 VS Code 与 GitHub Copilot Agent 模式的开发者，希望在聊天中直接查询自己有哪些 ADO 工作项，而不切换浏览器。
- 项目经理需要快速列出 'Contoso' 项目的迭代、团队和测试计划，用于站会前同步状态。
- 技术文档维护者让智能体根据系统设计内容创建或更新 Wiki 页面，例如 '/Getting Started'。
- 需要限制工具数量的客户端用户，通过 -d 只加载 core、work、work-items 等必要域，减少工具列表膨胀。
- 使用 Claude Code、Codex、Cursor 等 MCP 客户端的团队，想以统一协议把 Azure DevOps 上下文接入自有智能体。
- 希望零安装上手的团队直接使用远程 MCP Server，用 .vscode/mcp.json 中一行 URL 配置完成接入。
如何安装或部署这个 Agent？
推荐先使用远程服务器：在项目里创建 .vscode/mcp.json 并写入以下配置，把 {organization} 替换为你的 Azure DevOps 组织名。
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http"
}
},
"inputs": []
}仅当场景确实需要本地 stdio 连接时，才安装本地服务器。前置条件为 VS Code（或 VS Code Insiders）与 Node.js 20 或更高版本。用 npm 安装并配置：
{
"servers": {
"ado": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "{organization}"]
}
}
}如需夜间构建版本，把 @azure-devops/mcp 替换为 @azure-devops/mcp@next。
如何使用这个 Agent？
保存 .vscode/mcp.json 后，在 VS Code 的 MCP 视图中启动服务器（远程为 ado-remote-mcp，本地为 ado），然后用具备 Azure DevOps 访问权限的 Microsoft 账户登录，并执行如下提示词：
List ADO projects若希望智能体优先选择 ADO 工具，可在项目中添加 .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：
{
"servers": {
"ado_with_filtered_domains": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "{organization}", "-d", "core", "work", "work-items"]
}
}
}也可在 .vscode/mcp.json 中通过环境变量 ado_mcp_project 与 ado_mcp_team 设置默认项目和团队。
这个 Agent 有哪些优点和局限？
- 提供免安装的远程托管 MCP Server，只需在 .vscode/mcp.json 配置一个 URL 即可接入。
- 同时保留本地 stdio 版本，支持按 core、work、work-items、wiki、pipelines 等域裁剪工具，缓解客户端的工具数量限制。
- 直接对齐 Azure DevOps 官方 REST API，覆盖项目、工作项、仓库、流水线、测试计划与 Wiki 等核心对象。
- 文档明确列出 VS Code、Visual Studio 2022、Codex、Claude Code、Cursor、OpenCode、Kilo Code 等受支持客户端。
- 以 MIT 许可证开源，并给出贡献指南与问题模板。
- 深度绑定 Azure DevOps 与微软账户体系，其他代码托管平台的团队无法直接使用。
- 远程服务器仍处于预览阶段，官方说明将逐步取代本地服务器，现有本地用户需规划迁移。
- 本地版本要求 Node.js 20 或更高版本，并依赖 npx 联网获取 @azure-devops/mcp 包。
- README 只给出工具总数与域的概览，完整的本地工具清单需跳转 docs/TOOLSET.md 查看。
- 智能体需要正确选择工具，文档建议通过 copilot-instructions.md 显式提示，否则可能出现工具选择偏差。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Azure DevOps MCP Server 当前 | 61 · 存在缺口 | — | ★ 2.1k | 1 天前 | TypeScript | — |
| Argot 仓库风格审查器 | 93 · 表现优秀 | 命令行工具免费 | ★ 51 | 1 个月前 | Rust | Claude Code |
| OSS Autopilot | 83 · 表现良好 | Agent 插件 / 技能免费 | ★ 22 | 1 天前 | TypeScript | Claude Code · Claude.ai |
| Happier | 82 · 表现良好 | 桌面应用免费 + 模型费 | ★ 2k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
信任维度：域过滤（-d）与按需加载工具组体现了最小权限思路，但默认加载全部域，且写操作（创建/更新 wiki 页面、更新构建阶段）在工具层未见强制确认机制，故 least_privilege=2、user_confirmation=1。数据流方面 README 与 TROUBLESHOOTING 说明了认证方式（OAuth/azcli/envvar/PAT）与令牌环境变量，透明度尚可但未系统描述数据去向，data_flow_transparency=2。敏感数据处理：PAT 通过环境变量传入、支持 Entra ID 限制，但文档未强调令牌存储与日志脱敏，sensitive_data_handling=2。依赖安全：CI 使用固定 SHA 的 action、harden-runner、CodeQL 与 npm ci，但 package.json 依赖多为范围版本且未见审计/漏洞扫描说明，dependency_security=2。外部副作用：存在写操作但无回滚/撤销说明，external_effects=1、rollback=1。来源归属：LICENSE、package.json author、SECURITY.md 与商标声明清晰，source_attribution=2。
可靠性：README 推荐远程服务器而 FAQ 仍称仅支持本地版本，二者存在明显不一致，self_consistency=1。依赖可用性：npm 包发布、Node 20+ 要求、可选依赖与 CI 构建流程明确，dependency_availability=2。失败信息：TROUBLESHOOTING 对常见错误（组织名错误、headless 认证失败、多租户 TF400813）给出症状与根因，failure_messages=2。
适配性：README 覆盖 VS Code、Visual Studio、Claude Code、Cursor 等多客户端，audience_and_scenarios=2。能力边界：FAQ 明确仅支持 Azure DevOps Services、单组织、不支持个人账户，capability_boundaries=2。触发精度：提供 copilot-instructions 建议与域过滤以控制工具数量，trigger_precision=2。环境适配：文档覆盖 WSL2/SSH/Docker/CI 等 headless 场景的认证替代方案，environment_fit=2。
规范性：README 目录结构清晰、文档分文件组织，information_architecture=2。安装说明详尽（远程与本地、npm、域、默认项目/团队），install_notes=3。命名稳定性：包名与 bin 名一致，但文档中同时出现 npx @azure-devops/mcp 与 mcp-server-azuredevops 两种调用方式，naming_stability=2。示例与 FAQ：有示例与 FAQ，但示例文件未在证据中展开，examples_and_faq=2。已知限制：FAQ 与 TROUBLESHOOTING 列出限制，known_limitations=2。许可证：MIT 全文完整，license=3。版本与变更日志：package.json 有版本号且 CI 校验同步，但未见 CHANGELOG，versioning_changelog=1。维护责任：SECURITY.md 与贡献指南、微软归属明确，maintenance_responsibility=2。
有效性：工具聚焦单一 ADO 任务、输出经 content-safety 包装，output_usability=2。边际价值：为 agent 提供 ADO 上下文有实际价值，但远程服务器将取代本地版本，marginal_value=2。成本收益：需 Node 环境与认证配置，域过滤可降低工具数量成本，cost_benefit=2。
可验证性：README 声明多指向外部 Microsoft Learn 文档，仓库内证据有限，claim_traceability=1。交叉印证：README、FAQ、TROUBLESHOOTING 间存在远程服务器状态的不一致，cross_source_corroboration=1。事实与推断分离：文档多为操作性说明，缺少对安全/可靠性主张的明确证据标注，fact_inference_separation=1。
- README 推荐远程服务器而 FAQ 仍称仅支持本地版本，文档间存在不一致，使用前需确认当前支持状态。
- 写操作（创建/更新 wiki、更新构建阶段）未见工具层强制确认或回滚机制，agent 误操作可能产生不可逆外部副作用。
- PAT 通过环境变量传入，文档未强调令牌存储与日志脱敏，需自行确保环境变量与日志安全。
- 依赖使用范围版本且未见依赖漏洞审计说明，建议自行运行 npm audit。
- 本评估为静态源码审阅，未执行任何代码或测试，结论置信度低。