Azure DevOps MCP-Server

Eine Model Context Protocol (MCP)-Serverimplementierung für Azure DevOps, die es KI-Assistenten ermöglicht, über ein standardisiertes Protokoll mit Azure DevOps-APIs zu interagieren.

Überblick

Dieser Server implementiert das Model Context Protocol (MCP) für Azure DevOps und ermöglicht KI-Assistenten wie Claude die sichere Interaktion mit Azure DevOps-Ressourcen. Der Server fungiert als Brücke zwischen KI-Modellen und Azure DevOps-APIs und bietet eine standardisierte Möglichkeit für:

• Zugriff auf und Verwaltung von Projekten, Arbeitselementen, Repositories und mehr

• Erstellen und Aktualisieren von Arbeitselementen, Zweigen und Pull Requests

• Führen Sie gängige DevOps-Workflows mithilfe natürlicher Sprache aus

• Zugriff auf Repository-Inhalte über standardisierte Ressourcen-URIs

• Sichere Authentifizierung und Interaktion mit Azure DevOps-Ressourcen

Related MCP server: Azure DevOps MCP Server

Serverstruktur

Der Server basiert auf dem Model Context Protocol (MCP) für die Kommunikation mit KI-Assistenten. Er bietet Tools für die Interaktion mit Azure DevOps-Ressourcen, darunter:

• Projekte

• Arbeitselemente

• Repositorien

• Pull Requests

• Filialen

• Rohrleitungen

Kernkomponenten

• AzureDevOpsServer : Hauptserverklasse, die den MCP-Server initialisiert und Tools registriert

• Funktionsmodule : Organisiert nach Funktionsbereichen (Arbeitselemente, Projekte, Repositories usw.)

• Anforderungshandler : Jedes Funktionsmodul bietet Funktionen zur Anforderungsidentifizierung und -verarbeitung

• Tool Handlers : Modulare Funktionen für jeden Azure DevOps-Vorgang

• Konfiguration : Umgebungsbasierte Konfiguration für Organisations-URL, PAT usw.

Der Server verwendet eine featurebasierte Architektur, bei der jeder Funktionsbereich (wie Arbeitselemente, Projekte, Repositories) in einem eigenen Modul gekapselt ist. Dies macht die Codebasis wartungsfreundlicher und erleichtert die Erweiterung um neue Funktionen.

Erste Schritte

Voraussetzungen

• Node.js (v16+)

• npm oder yarn

• Azure DevOps-Konto mit entsprechendem Zugriff

• Authentifizierungsdaten (weitere Einzelheiten finden Sie im Authentifizierungshandbuch ):

  • Persönlicher Zugriffstoken (PAT) oder

  • Azure Identity-Anmeldeinformationen oder

  • Azure CLI-Anmeldung

Ausführen mit NPX

Verwendung mit Claude Desktop/Cursor AI

Zur Integration mit Claude Desktop oder Cursor AI fügen Sie Ihrer Konfigurationsdatei eine der folgenden Konfigurationen hinzu.

Azure-Identitätsauthentifizierung

Stellen Sie sicher, dass Sie mit az login “ bei Azure CLI angemeldet sind, und fügen Sie dann Folgendes hinzu:

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

Authentifizierung mit persönlichem Zugriffstoken (PAT)

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "pat",
        "AZURE_DEVOPS_PAT": "<YOUR_PAT>",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

Ausführliche Konfigurationsanweisungen und weitere Authentifizierungsoptionen finden Sie im Authentifizierungshandbuch .

Authentifizierungsmethoden

Dieser Server unterstützt mehrere Authentifizierungsmethoden für die Verbindung mit Azure DevOps-APIs. Ausführliche Einrichtungsanweisungen, Konfigurationsbeispiele und Tipps zur Fehlerbehebung finden Sie im Authentifizierungshandbuch .

Unterstützte Authentifizierungsmethoden

1. Personal Access Token (PAT) – Einfache tokenbasierte Authentifizierung

2. Azure Identity (DefaultAzureCredential) – Flexible Authentifizierung mit dem Azure Identity SDK

3. Azure CLI – Authentifizierung mit Ihrem Azure CLI-Login

Beispielkonfigurationsdateien für jede Authentifizierungsmethode sind im Verzeichnis „Beispiele“ verfügbar.

Umgebungsvariablen

Eine vollständige Liste der Umgebungsvariablen und ihrer Beschreibungen finden Sie im Authentifizierungshandbuch .

Zu den wichtigsten Umgebungsvariablen gehören:

Fehlerbehebung bei der Authentifizierung

Ausführliche Informationen zur Fehlerbehebung für die einzelnen Authentifizierungsmethoden finden Sie im Authentifizierungshandbuch .

Zu den häufigsten Problemen gehören:

• Ungültige oder abgelaufene Anmeldeinformationen

• Unzureichende Berechtigungen

• Probleme mit der Netzwerkverbindung

• Konfigurationsfehler

Details zur Authentifizierungsimplementierung

Technische Details zur Implementierung der Authentifizierung im Azure DevOps MCP-Server finden Sie im Authentifizierungshandbuch und im Quellcode im Verzeichnis src/auth .

Verfügbare Tools

Der Azure DevOps MCP-Server bietet verschiedene Tools für die Interaktion mit Azure DevOps-Ressourcen. Ausführliche Informationen zu den einzelnen Tools finden Sie in der entsprechenden Dokumentation.

Benutzertools

• get_me : Details des authentifizierten Benutzers abrufen (ID, Anzeigename, E-Mail)

Organisationstools

• list_organizations : Listet alle zugänglichen Organisationen auf

Projekt-Tools

• list_projects : Listet alle Projekte in einer Organisation auf

• get_project : Details zu einem bestimmten Projekt abrufen

• get_project_details : Erhalten Sie umfassende Details eines Projekts, einschließlich Prozess, Arbeitselementtypen und Teams

Repository-Tools

• list_repositories : Listet alle Repositories in einem Projekt auf

• get_repository : Details zu einem bestimmten Repository abrufen

• get_repository_details : Erhalten Sie detaillierte Informationen zu einem Repository, einschließlich Statistiken und Referenzen

• get_file_content : Inhalt einer Datei oder eines Verzeichnisses aus einem Repository abrufen

Arbeitselementtools

• get_work_item : Ruft ein Arbeitselement nach ID ab

• create_work_item : Ein neues Arbeitselement erstellen

• update_work_item : Aktualisieren Sie ein vorhandenes Arbeitselement

• list_work_items : Arbeitselemente in einem Projekt auflisten

• manage_work_item_link : Links zwischen Arbeitselementen hinzufügen, entfernen oder aktualisieren

Suchwerkzeuge

• search_code : Suche nach Code in allen Repositories eines Projekts

• search_wiki : Suche nach Inhalten auf allen Wiki-Seiten in einem Projekt

• search_work_items : Suche nach Arbeitselementen in allen Projekten in Azure DevOps

Pipeline-Tools

• list_pipelines : Listet Pipelines in einem Projekt auf

• get_pipeline : Details einer bestimmten Pipeline abrufen

• trigger_pipeline : Lösen Sie einen Pipeline-Lauf mit anpassbaren Parametern aus

Wiki-Tools

• get_wikis : Listet alle Wikis in einem Projekt auf

• get_wiki_page : Ruft den Inhalt einer bestimmten Wiki-Seite als Klartext ab

Pull Request-Tools

• create_pull_request – Erstelle einen neuen Pull Request

• list_pull_requests – Pull Requests in einem Repository auflisten

• add_pull_request_comment – Einen Kommentar zu einem Pull Request hinzufügen

• get_pull_request_comments - Kommentare aus einem Pull Request abrufen

• update_pull_request – Aktualisieren Sie eine vorhandene Pull-Anforderung (Titel, Beschreibung, Status, Entwurfsstatus, Prüfer, Arbeitselemente).

Eine umfassende Dokumentation zu allen Tools finden Sie in der Tool-Dokumentation .

Beitragen

Beiträge sind willkommen! Die Richtlinien für Beiträge finden Sie unter CONTRIBUTING.md .

Sternengeschichte

Lizenz

MIT