mcp-azure-devops

mcp-azure-devops

一个适用于 Azure DevOps 的模型上下文协议服务。它允许具备 MCP 能力的客户端（Claude Desktop、Claude Code、Cursor、Codex、……）在看板、代码仓库、流水线和项目中开展工作，并通过治理层确保 AI Agent 不越过安全边界。

功能介绍

• 项目和团队 — 列出项目、团队和成员，并检查流程模板。
• 看板 / 工作项 — 执行 WIQL 查询、获取工作项、创建/更新工作项、列出迭代（冲刺）。
• 代码仓库 / 拉取请求 — 列出代码仓库和分支，列出/获取 PR，创建 PR。
• 流水线 / 构建 — 列出流水线和近期构建、获取构建、触发运行。
• 管理 / 流程 — 列出流程模板、创建项目、删除项目（受保护）。
• 内置治理 — 访问模式、项目允许列表、受保护项目、删除门控、高影响操作的输入确认、试运行和 JSON 审计日志。

治理与安全模型

关注事项	标志	默认值	效果
服务可以执行哪些操作？	AZDO_MODE	read-only	read-only → 读取；read-write → 工作项、PR、流水线运行；admin → 创建/删除项目。高于当前模式权限的工具绝不会注册。
哪些项目在范围内？	AZDO_PROJECT_ALLOWLIST	(全部)	拒绝对其他项目执行操作。
哪些项目始终为只读？	AZDO_PROTECTED_PROJECTS	(无)	可以读取，但绝不能修改。
是否允许删除？	AZDO_ALLOW_DELETE	false	delete_project 需要启用此项且使用管理模式。
输入确认	AZDO_REQUIRE_CONFIRMATION	true	高影响操作要求 confirm 与目标名称完全一致，而不只是布尔值。
预览	AZDO_DRY_RUN	false	写入/管理工具会验证并记录操作意图，然后返回。
审计记录	AZDO_AUDIT_LOG	true	每次受保护操作都会向 stderr 写入一行 JSON。
交互式确认	(自动)	—	运行破坏性和高影响操作前，会通过 MCP elicitation 提示人工批准；不支持 elicitation 的客户端则使用 *_ALLOW_* 门控。

工具

读取（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）

快速开始 — 添加到你的 Agent

已发布到 npm，包名为 @dockndevai/mcp-azure-devops。通过 npx 运行；需要组织和 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 所有权验证提供 mcpName。请参阅 PUBLISHING.md。

许可证

MIT