@slorenzot/mcp-azure
@slorenzot/mcp-azure
MCP-Server (Model Context Protocol) für Azure DevOps. Ermöglicht die Interaktion mit Arbeitselementen (Work Items), Git-Repositories, Pull Requests, Sprints, Bereichen, Kommentaren und Anhängen von jedem kompatiblen MCP-Client aus.
Installation
npm install -g @slorenzot/mcp-azureOder direkt mit npx verwenden:
npx @slorenzot/mcp-azureRelated MCP server: devops-wrangler
Konfiguration
Umgebungsvariablen
Der Server wird automatisch über die folgenden Umgebungsvariablen konfiguriert:
Variable | Alternative | Beschreibung | Erforderlich |
|
| URL der Organisation (z. B. | Ja |
|
| Personal Access Token | Ja |
|
| Name des Projekts | Nein |
Konfiguration in Claude Desktop
Fügen Sie die folgende Konfiguration zu Ihrer claude_desktop_config.json-Datei hinzu:
{
"mcpServers": {
"azure-devops": {
"command": "npx",
"args": ["-y", "@slorenzot/mcp-azure"],
"env": {
"AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
"AZURE_DEVOPS_PAT": "tu-pat-aqui",
"AZURE_DEVOPS_PROJECT": "tu-proyecto"
}
}
}
}Konfiguration in OpenCode
OpenCode verwendet dasselbe MCP, aber die Konfiguration kann auf zwei Arten erfolgen:
Option 1: Erstkonfiguration mit Umgebungsvariablen
Konfigurieren Sie die Umgebungsvariablen in Ihrem System oder in Ihrer OpenCode-Konfiguration:
export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion" export AZURE_DEVOPS_PAT="tu-pat-aqui" export AZURE_DEVOPS_PROJECT="tu-proyecto"Oder fügen Sie den MCP-Server in Ihrer OpenCode-Konfiguration hinzu:
{ "mcpServers": { "azure-devops": { "command": "npx", "args": ["-y", "@slorenzot/mcp-azure"], "env": { "AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion", "AZURE_DEVOPS_PAT": "tu-pat-aqui", "AZURE_DEVOPS_PROJECT": "tu-proyecto" } } } }
Option 2: Dynamische Konfiguration mit ado_configure
OpenCode ermöglicht es, die Verbindung während der Sitzung direkt über den Befehl ado_configure zu konfigurieren:
{
"organization": "https://dev.azure.com/tu-organizacion",
"project": "tu-proyecto",
"pat": "tu-pat-aqui"
}Diese Option ist nützlich, um zwischen verschiedenen Organisationen oder Projekten zu wechseln, ohne die Konfigurationsdatei zu ändern.
Hinweis: Wenn Sie ado_configure verwenden, bleibt die Verbindung während der aktuellen OpenCode-Sitzung bestehen.
Personal Access Token (PAT) abrufen
Gehen Sie zu Ihrer Azure DevOps-Organisation
Klicken Sie auf Ihren Avatar (obere rechte Ecke)
Wählen Sie Personal Access Tokens
Erstellen Sie ein neues Token mit den folgenden Berechtigungen:
Work Items: Read & Write
Code: Read & Write (für Repository- und Pull Request-Operationen)
Project and Team: Read (optional)
Verfügbare Tools
Authentifizierung
Tool | Beschreibung |
| Konfiguriert die Verbindung mit Organisation, Projekt und PAT |
Work Items
Tool | Beschreibung |
| Ruft ein Work Item über seine ID ab |
| Erstellt ein neues Work Item (User Story, Bug, Task, etc.) |
| Aktualisiert ein bestehendes Work Item |
| Ruft die verfügbaren/erforderlichen Felder eines Typs ab |
Abfragen
Tool | Beschreibung |
| Fragt Work Items eines bestimmten Sprints ab |
| Fragt Work Items eines bestimmten Bereichs ab |
| Führt eine benutzerdefinierte WIQL-Abfrage aus |
Projektstruktur
Tool | Beschreibung |
| Listet die Iterationen/Sprints des Projekts auf |
| Listet die Bereiche des Projekts auf |
Git-Repositories
Tool | Beschreibung |
| Listet alle Git-Repositories des Projekts auf |
| Ruft Details eines bestimmten Repositories nach Name oder ID ab |
| Listet die Branches eines Repositories auf |
Pull Requests
Tool | Beschreibung |
| Listet Pull Requests mit optionalen Filtern auf (Status, Branches, Ersteller, Prüfer) |
| Ruft vollständige Details eines Pull Requests ab |
| Erstellt einen neuen Pull Request |
| Aktualisiert Eigenschaften eines Pull Requests (Titel, Beschreibung, Entwurf) |
| Schließt (merge) einen Pull Request mit konfigurierbarer Strategie ab |
| Bricht einen Pull Request ab |
Pull Request Reviews
Tool | Beschreibung |
| Genehmigt einen Pull Request (Stimme: 10) |
| Lehnt einen Pull Request ab (Stimme: -10) |
| Ruft alle Prüfer und deren Stimmen eines Pull Requests ab |
| Fügt einen Prüfer zu einem Pull Request hinzu |
Pull Request Kommentare
Tool | Beschreibung |
| Ruft alle Kommentar-Threads eines Pull Requests ab |
| Erstellt einen neuen Kommentar-Thread (allgemein oder für Code) |
| Antwortet auf einen bestehenden Kommentar-Thread |
Pull Request Info
Tool | Beschreibung |
| Ruft alle Commits eines Pull Requests ab |
| Ruft die mit einem Pull Request verknüpften Work Items ab |
| Aktualisiert den Status eines Kommentar-Threads (Fixed, WontFix, etc.) |
Kommentare und Diskussionen
Tool | Beschreibung |
| Fügt einem Work Item einen Kommentar hinzu (unterstützt Markdown) |
| Ruft die Kommentare eines Work Items ab |
Anhänge
Tool | Beschreibung |
| Lädt eine Datei hoch und gibt die URL des Anhangs zurück |
| Fügt einem Work Item einen Anhang hinzu |
| Listet die Anhänge eines Work Items auf |
Anwendungsbeispiele
Eine User Story erstellen
{
"title": "Implementar login con OAuth",
"type": "User Story",
"description": "Como usuario quiero poder iniciar sesión con mi cuenta de Google",
"areaPath": "MiProyecto\\Backend",
"iterationPath": "MiProyecto\\Sprint 5",
"fields": {
"Custom.OKR": "Seguridad",
"Custom.Prioridad": "Alta"
}
}Benutzerdefinierte WIQL-Abfrage
{
"wiql": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = @Me ORDER BY [System.CreatedDate] DESC",
"getDetails": true
}Kommentar mit Markdown hinzufügen
{
"id": 12345,
"comment": "## Análisis completado\n\n- Revisado el código\n- Identificados 3 issues\n\n**Próximo paso:** Corregir validaciones"
}Datei hochladen und anhängen
{
"workItemId": 12345,
"filePath": "/ruta/al/archivo.pdf",
"comment": "Documento de especificaciones",
"name": "Especificaciones Funcionales v2.0"
}Bestehenden Anhang verknüpfen
{
"workItemId": 12345,
"attachmentUrl": "https://dev.azure.com/org/proj/_apis/wit/attachments/abc123",
"comment": "Diseño de arquitectura",
"name": "Arquitectura del Sistema"
}Repositories auflisten
{
"includeHidden": false,
"top": 50
}Aktive Pull Requests auflisten
{
"status": "Active",
"top": 20
}Einen Pull Request erstellen
{
"repositoryId": "mi-repo",
"sourceRefName": "refs/heads/feature-login",
"targetRefName": "refs/heads/main",
"title": "Implementar login con OAuth",
"description": "Esta PR agrega soporte para login con Google OAuth",
"reviewerIds": ["12345678-1234-1234-1234-1234567890ab"],
"isDraft": false
}Einen Pull Request genehmigen
{
"pullRequestId": 12345,
"repositoryId": "mi-repo"
}Einen Pull Request abschließen (Merge)
{
"pullRequestId": 12345,
"repositoryId": "mi-repo",
"mergeStrategy": "Squash",
"deleteSourceBranch": true,
"mergeCommitMessage": "Merge de feature-login"
}Kommentar im Code erstellen
{
"pullRequestId": 12345,
"repositoryId": "mi-repo",
"content": "Por favor extraer esto en una función separada",
"filePath": "/src/components/Login.tsx",
"startLine": 45,
"endLine": 52
}Verfügbare Prompts
Der Server enthält vordefinierte Prompts, um häufige Aufgaben zu erleichtern:
Prompt | Beschreibung |
| Anleitung zur Verbindung mit Azure DevOps |
| Analysiert den Status eines Sprints |
| Erstellt eine strukturierte User Story |
| Generiert einen täglichen Standup-Bericht |
| Hilft bei der Planung eines Sprints |
| Aktualisiert mehrere Work Items gleichzeitig |
| Generiert einen Projektbericht |
| Erstellt einen strukturierten Fehlerbericht |
Ressourcen
Ressource | URI | Beschreibung |
Verbindungsstatus |
| Informationen zum aktuellen Verbindungsstatus |
Entwicklung
Voraussetzungen
Node.js 18+
npm oder yarn
Lokale Installation
git clone https://github.com/slorenzot/mcp-azure.git
cd mcp-azure
npm install
npm run buildVerfügbare Skripte
npm run build # Compila TypeScript
npm run start # Inicia el servidor
npm run dev # Modo desarrollo con watchLizenz
MIT
Autor
Soulberto Lorenzo - @slorenzot
Version
2.4.1 - 34 Tools für Azure DevOps verfügbar (Work Items, Git-Repositories, Pull Requests, etc.)
Available Tools
36 toolsado_abandon_pull_requestC
Abandona un Pull Request (cambia estado a Abandoned).
Inputs: pullRequestId (required), repositoryId.
ado_add_attachmentB
Agrega un adjunto a un Work Item existente. Maneja automáticamente concurrencia cuando múltiples adjuntos se agregan al mismo WI.
Inputs: workItemId (required), name, comment, filePath, +1 more.
ado_add_commentB
Agrega un comentario/entrada de discusión a un Work Item. Soporta formato Markdown.
Inputs: id (required), comment (required).
ado_add_pull_request_reviewerB
Agrega un revisor a un Pull Request.
Inputs: reviewerId (required), pullRequestId (required), vote, repositoryId.
ado_approve_pull_requestB
Aprueba un Pull Request (voto: 10).
Inputs: pullRequestId (required), reviewerId, repositoryId.
ado_complete_pull_requestC
Completa (merge) un Pull Request.
Inputs: pullRequestId (required), repositoryId, mergeStrategy, deleteSourceBranch, +2 more.
ado_configureB
Configura la conexión a Azure DevOps con token de acceso personal (PAT).
Inputs: pat (required), project (required), organization (required).
ado_create_pull_requestC
Crea un nuevo Pull Request.
Inputs: title (required), repositoryId (required), sourceRefName (required), targetRefName (required), +3 more.
ado_create_pull_request_threadB
Crea un nuevo hilo de comentarios (comentario general o comentario de código).
Inputs: content (required), pullRequestId (required), endLine, filePath, +2 more.
ado_create_work_itemA
Crea un nuevo Work Item en Azure DevOps. Usa ado_get_work_item_type_fields para ver campos requeridos.
Inputs: type (required), title (required), fields, areaPath, +3 more.
ado_delete_attachmentB
Elimina un adjunto de un Work Item removiendo su relación. Maneja automáticamente concurrencia cuando múltiples cambios afectan el mismo WI.
Inputs: workItemId (required), comment, attachmentUrl, attachmentName.
ado_delete_work_itemA
Elimina un Work Item en Azure DevOps. Por defecto realiza borrado lógico; usa destroy=true solo para eliminación permanente.
Inputs: id (required), confirm (required), destroy, expectedType.
ado_get_attachmentsB
Obtiene la lista de adjuntos de un Work Item
Inputs: id (required).
ado_get_commentsB
Obtiene los comentarios/historial de discusión de un Work Item
Inputs: id (required), top.
ado_get_pull_requestC
Obtiene detalles completos de un Pull Request.
Inputs: pullRequestId (required), repositoryId, includeCommits, includeWorkItems.
ado_get_pull_request_commitsC
Obtiene todos los commits de un Pull Request.
Inputs: pullRequestId (required), top, repositoryId.
ado_get_pull_request_reviewersA
Obtiene todos los revisores y sus votos de un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_pull_request_threadsB
Obtiene todos los hilos de comentarios de un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_pull_request_work_itemsB
Obtiene los work items vinculados a un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_repositoryB
Obtiene detalles de un repositorio específico por nombre o ID.
Inputs: repositoryId (required).
ado_get_work_itemB
Obtiene un Work Item de Azure DevOps por su ID
Inputs: id (required), full.
ado_get_work_item_type_fieldsB
Obtiene los campos disponibles y requeridos para un tipo de Work Item
Inputs: workItemType (required).
ado_list_areasA
Lista las áreas disponibles en el proyecto
Inputs: no named parameters.
ado_list_branchesB
Lista las ramas (branches) de un repositorio.
Inputs: repositoryId (required), filter, includeStatuses.
ado_list_iterationsA
Lista las iteraciones/sprints disponibles en el proyecto
Inputs: no named parameters.
ado_list_pull_requestsA
Lista Pull Requests con filtros opcionales. Busca por repositorio o en todo el proyecto.
Inputs: top, status, creatorId, reviewerId, +3 more.
ado_list_repositoriesA
Lista todos los repositorios Git del proyecto.
Inputs: top, includeHidden.
ado_query_areaC
Consulta User Stories de un área específica en Azure DevOps
Inputs: areaPath (required), workItemType.
ado_query_sprintA
Consulta User Stories de un sprint específico en Azure DevOps
Inputs: iterationPath (required), state.
ado_query_wiqlC
Ejecuta una consulta WIQL personalizada en Azure DevOps
Inputs: wiql (required), getDetails.
ado_reject_pull_requestC
Rechaza un Pull Request (voto: -10).
Inputs: pullRequestId (required), reviewerId, repositoryId.
ado_reply_to_pull_request_threadC
Responde a un hilo de comentarios existente.
Inputs: content (required), threadId (required), pullRequestId (required), repositoryId.
ado_update_pull_requestC
Actualiza propiedades de un Pull Request (título, descripción, estado de borrador).
Inputs: pullRequestId (required), title, isDraft, description, +1 more.
ado_update_pull_request_thread_statusC
Actualiza el estado de un hilo de comentarios (ej: marcar como Fixed, WontFix, etc.).
Inputs: status (required), threadId (required), pullRequestId (required), repositoryId.
ado_update_work_itemC
Actualiza un Work Item existente en Azure DevOps
Inputs: id (required), state, title, fields, +2 more.
ado_upload_attachmentC
Sube un archivo como adjunto a Azure DevOps y devuelve la URL del adjunto
Inputs: filePath (required), fileName.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Each tool targets a distinct action and resource (e.g., create vs update vs delete work items, add vs upload attachments). No two tools have ambiguous purposes, ensuring clear agent selection.
All tools follow the consistent pattern 'ado_verb_noun' (e.g., ado_create_work_item, ado_list_repositories). The prefix and verb-noun structure are uniform, making it easy to predict tool names.
36 tools is slightly above the typical range, but the Azure DevOps domain is broad. Each tool covers a necessary operation (work items, PRs, repositories, queries, etc.), so the count feels justified rather than bloated.
The tool surface covers the main workflows: CRUD for work items and pull requests, attachments, comments, threads, repositories, and queries. Minor gaps exist (e.g., no create/delete branch or build pipeline tools), but core operations are present.
Maintenance
Related MCP Connectors
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
MCP server for building and testing AI agents with multi-model experimentation and insights.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI assistants to manage Azure DevOps resources including Work Items, Git repositories, pipelines, and user identities.20 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server for Azure DevOps work item management that enables AI assistants to create, query, update, and manage work items, sprints, and more.129 npmISC
- AlicenseNot gradedqualityDmaintenanceMCP server for Azure DevOps Server 2022 (on-premises) that enables AI assistants to interact with work items, repositories, builds, and sprints through 29 tools.33 npmMIT
- AlicenseNot gradedqualityDmaintenanceA focused MCP server for Azure DevOps work item administration, enabling AI agents to create, update, query, and manage work items with full CRUD operations and advanced WIQL querying.MIT