@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-azureKonfiguration
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.)
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/soulberto/mcp-azure'
If you have feedback or need assistance with the MCP directory API, please join our Discord server