Azure DevOps MCP Server

Integrations

  • Utilizes environment variables for configuration of organization URL, Personal Access Token, and default project settings.

  • Enables interaction with Git repositories in Azure DevOps, including accessing repository details and branch information.

  • Runs on Node.js to provide a server implementation for communicating with Azure DevOps resources via the Model Context Protocol.

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

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:

VariableBeschreibungErforderlichStandard
AZURE_DEVOPS_AUTH_METHODAuthentifizierungsmethode ( pat , azure-identity oder azure-cli ) – ohne Berücksichtigung der Groß-/KleinschreibungNEINazure-identity
AZURE_DEVOPS_ORG_URLVollständige URL zu Ihrer Azure DevOps-OrganisationJa-
AZURE_DEVOPS_PATPersönlicher Zugriffstoken (für PAT-Authentifizierung)Nur mit PAT-Authentifizierung-
AZURE_DEVOPS_DEFAULT_PROJECTStandardprojekt, wenn keines angegeben istNEIN-
AZURE_DEVOPS_API_VERSIONZu verwendende API-VersionNEINLetzte
AZURE_TENANT_IDAzure AD-Mandanten-ID (für Dienstprinzipale)Nur mit Dienstprinzipalen-
AZURE_CLIENT_IDAzure AD-Anwendungs-ID (für Dienstprinzipale)Nur mit Dienstprinzipalen-
AZURE_CLIENT_SECRETAzure AD-Clientgeheimnis (für Dienstprinzipale)Nur mit Dienstprinzipalen-
LOG_LEVELProtokollierungsebene (Debug, Info, Warnen, Fehler)NEINInfo

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein Model Context Protocol-Server, der es KI-Assistenten ermöglicht, über ein standardisiertes Protokoll mit Azure DevOps-Ressourcen wie Projekten, Arbeitselementen, Repositorys, Pull Requests, Zweigen und Pipelines zu interagieren.

  1. Überblick
    1. Serverstruktur
      1. Kernkomponenten
    2. Erste Schritte
      1. Voraussetzungen
      2. Ausführen mit NPX
      3. Verwendung mit Claude Desktop/Cursor AI
    3. Authentifizierungsmethoden
      1. Unterstützte Authentifizierungsmethoden
    4. Umgebungsvariablen
      1. Fehlerbehebung bei der Authentifizierung
        1. Details zur Authentifizierungsimplementierung
          1. Verfügbare Tools
            1. Benutzertools
            2. Organisationstools
            3. Projekt-Tools
            4. Repository-Tools
            5. Arbeitselementtools
            6. Suchwerkzeuge
            7. Pipeline-Tools
            8. Wiki-Tools
            9. Pull Request-Tools
          2. Beitragen
            1. Sternengeschichte
              1. Lizenz

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  This server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standardized interface for communicating with Azure DevOps
                  Last updated -
                  96
                  18
                  TypeScript
                  MIT License
                • -
                  security
                  -
                  license
                  -
                  quality
                  A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
                  Last updated -
                  20
                  2
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A reference server implementation for the Model Context Protocol that enables AI assistants to interact with Azure DevOps resources and perform operations such as project management, work item tracking, repository operations, and code search programmatically.
                  Last updated -
                  3
                  TypeScript
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants to interact with Azure DevOps services, allowing users to query work items with plans to support creating/updating items, managing pipelines, handling pull requests, and administering sprints and branch policies.
                  Last updated -
                  9
                  16
                  Python
                  MIT License
                  • Linux
                  • Apple

                View all related MCP servers

                ID: vbqbnnzcdd