mcp-azure-devops

Ein Model Context Protocol-Server für Azure DevOps. Er ermöglicht einem MCP-fähigen Client (Claude Desktop, Claude Code, Cursor, Codex, …), mit Boards, Repos, Pipelines und Projekten zu arbeiten – mit einer Governance-Schicht, die einen KI-Agenten innerhalb sicherer Grenzen hält.

Was dieses Paket bietet

• Projekte & Teams – Projekte/Teams/Mitglieder auflisten, Prozessvorlagen inspizieren.

• Boards / Work Items – WIQL-Abfragen, Work Items abrufen, Work Items anlegen/aktualisieren, Iterationen (Sprints) auflisten.

• Repos / Pull Requests – Repos und Branches auflisten, Pull Requests auflisten/abrufen, Pull Requests anlegen.

• Pipelines / Builds – Pipelines und letzte Builds auflisten, einen Build abrufen, einen Lauf in die Warteschlange einstellen.

• Admin / Prozess – Prozessvorlagen auflisten, ein Projekt anlegen, ein Projekt löschen (abgesichert).

• Governance eingebaut – Zugriffsmodi, Projekt-Allowlisten, geschützte Projekte, Lösch-Gate, textbasierte Bestätigung für kritische Operationen, Trockenlauf und JSON-Audit-Protokollierung.

Related MCP server: Azure DevOps MCP Server

Governance- und Sicherheitsmodell

Tools

Lesen (read-only+): list_projects, getprojects, 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

Schreiben (read-write+): create_work_item, update_work_item, create_pull_request, run_pass

Admin (admin): create_project, delete_project (erfordert AZDO_ALLOW_DELETE + eingegebene Bestätigung confirm)

Schnellstart – zum Agenten hinzufügen

Auf npm verfügbar als @dockndevai/mcp-azure-devops. Läuf über npx; benötigt eine Org and ein PAT. Siehe docs/CLIENTS.md für alle Clients und .env.example für alle Variablen.

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

Beispiel-Prompts

• "Liste die aktiven Pull Requests im api-Repository des Projekts Payments auf."

• "Frage Work Items a, die mIr zugewiesen sind und noch den Status Active haben."

• "Zeige die letsten 10 Builds im Projekt Web und welche davon fehlgeschlagen sind."

• "Erstelle a Bug im Payerments-Projekt mit dem Teitel 'Checkout 500 on retry'." (benötigt read-write)

Aus dem Codel starten (Entwicklung)

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

Entwickeln

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

Veröffentlichung

Liefert ein server.json für die offziielle MCP-Registry und ein mcpName für die npm-Inhaberprüfung mit. Siehe PUBLISHING.md.

Lizenz

MIT