mcp-azure-devops

一个用于 Azure DevOps 的 Model Context Protocol 服务器。它能让支持 MCP 的客户端（Claude Desktop、Claude Code、Cursor、Codex……）跨 Boards、Repos、Pipelines 和项目 工作——并带有治理层，让 AI 智能体始终处于安全边界内。

功能概览

• 项目与团队 —— 列出项目/团队/成员，检查流程模板。

• Boards / 工作项 —— WIQL 查询、获取工作项、创建/更新工作项、列出迭代（sprint）。

• Repos / 拉取请求 —— 列仓库和分支，列出/查看 PR，创建 PR。

• Pipelines / 构建 —— 列流水线和最近的构建，获取某次构建，触发一次运行。

• 管理 / 流程 —— 列出流程模板，创建项目，删除项目（受管控）。

• 内置治理 —— 访问模式、项目白名单、受保护项目、删除门禁、高影响操作的类型化确认、dry-run 以及 JSON 审计日志。

Related MCP server: Azure DevOps MCP Server

治理与安全模型

工具

读取（read-only+）：list_projects、get_project、list_teams、list_team_members、list_processes、query_work_items、get_work_item、list_iterations、list_repositories、list_branches、list_pull_requests、get_pull_request、list_pipelines、list_builds、get_build

写入（read-write+）：create_work_item、update_work_item、create_pull_request、run_pipeline

管理（admin）：create_project、delete_project（需要 AZDO_ALLOW_DELETE，且 confirm 必须输入目标名称）

快速开始——添加到你的客户端

已发布到 npm，包名为 @dockndevai/mcp-azure-devops。通过 npx 运行；需要一个组织（org）和一个 PAT。有关每个客户端的完整设置，请参阅 docs/CLIENTS.md；所有环境变量请参阅 .env.example。

Claude Code

claude mcp add azure-devops -e AZDO_ORG_URL="https://dev.azure.com/your-org" -e AZDO_PAT="your-pat" -e AZDO_MODE="read-only" -- npx -y @dockndevai/mcp-azure-devops

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure-devops"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat",
        "AZDO_MODE": "read-only"
      }
    }
  }
}

示例提示词

• "列出 Payments 项目的 api 仓库中的活动拉取请求"

• "查询分配给我且状态仍为 Active 的工作项"

• "显示 Web 项目中最后 10 次构建，以及有哪些失败"

• "在 Payments 中新建一条标题为 'Checkout 500 on retry' 的 Bug"（需要 read-write 权限）

从源码运行（开发）

npm install
npm run build
node dist/index.js   # with the environment variables set

开发

npm run dev
npm test          # governance policy: modes, allowlists, delete gating, confirmation
npm run typecheck

发布

为官方 MCP 注册表提供了一个 server.json，并为 npm 所有权校验提供了 package.json 中的 mcpName。详见 PUBLISHING.md。

许可证

MIT