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:
Authentifizierung mit persönlichem Zugriffstoken (PAT)
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
- Personal Access Token (PAT) – Einfache tokenbasierte Authentifizierung
- Azure Identity (DefaultAzureCredential) – Flexible Authentifizierung mit dem Azure Identity SDK
- 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:
Variable | Beschreibung | Erforderlich | Standard |
---|---|---|---|
AZURE_DEVOPS_AUTH_METHOD | Authentifizierungsmethode ( pat , azure-identity oder azure-cli ) – ohne Berücksichtigung der Groß-/Kleinschreibung | NEIN | azure-identity |
AZURE_DEVOPS_ORG_URL | Vollständige URL zu Ihrer Azure DevOps-Organisation | Ja | - |
AZURE_DEVOPS_PAT | Persönlicher Zugriffstoken (für PAT-Authentifizierung) | Nur mit PAT-Authentifizierung | - |
AZURE_DEVOPS_DEFAULT_PROJECT | Standardprojekt, wenn keines angegeben ist | NEIN | - |
AZURE_DEVOPS_API_VERSION | Zu verwendende API-Version | NEIN | Letzte |
AZURE_TENANT_ID | Azure AD-Mandanten-ID (für Dienstprinzipale) | Nur mit Dienstprinzipalen | - |
AZURE_CLIENT_ID | Azure AD-Anwendungs-ID (für Dienstprinzipale) | Nur mit Dienstprinzipalen | - |
AZURE_CLIENT_SECRET | Azure AD-Clientgeheimnis (für Dienstprinzipale) | Nur mit Dienstprinzipalen | - |
LOG_LEVEL | Protokollierungsebene (Debug, Info, Warnen, Fehler) | NEIN | Info |
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 aufget_project
: Details zu einem bestimmten Projekt abrufenget_project_details
: Erhalten Sie umfassende Details eines Projekts, einschließlich Prozess, Arbeitselementtypen und Teams
Repository-Tools
list_repositories
: Listet alle Repositories in einem Projekt aufget_repository
: Details zu einem bestimmten Repository abrufenget_repository_details
: Erhalten Sie detaillierte Informationen zu einem Repository, einschließlich Statistiken und Referenzenget_file_content
: Inhalt einer Datei oder eines Verzeichnisses aus einem Repository abrufen
Arbeitselementtools
get_work_item
: Ruft ein Arbeitselement nach ID abcreate_work_item
: Ein neues Arbeitselement erstellenupdate_work_item
: Aktualisieren Sie ein vorhandenes Arbeitselementlist_work_items
: Arbeitselemente in einem Projekt auflistenmanage_work_item_link
: Links zwischen Arbeitselementen hinzufügen, entfernen oder aktualisieren
Suchwerkzeuge
search_code
: Suche nach Code in allen Repositories eines Projektssearch_wiki
: Suche nach Inhalten auf allen Wiki-Seiten in einem Projektsearch_work_items
: Suche nach Arbeitselementen in allen Projekten in Azure DevOps
Pipeline-Tools
list_pipelines
: Listet Pipelines in einem Projekt aufget_pipeline
: Details einer bestimmten Pipeline abrufentrigger_pipeline
: Lösen Sie einen Pipeline-Lauf mit anpassbaren Parametern aus
Wiki-Tools
get_wikis
: Listet alle Wikis in einem Projekt aufget_wiki_page
: Ruft den Inhalt einer bestimmten Wiki-Seite als Klartext ab
Pull Request-Tools
create_pull_request
– Erstelle einen neuen Pull Requestlist_pull_requests
– Pull Requests in einem Repository auflistenadd_pull_request_comment
– Einen Kommentar zu einem Pull Request hinzufügenget_pull_request_comments
- Kommentare aus einem Pull Request abrufenupdate_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
You must be authenticated.
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.
Tools
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.
- Überblick
- Serverstruktur
- Erste Schritte
- Authentifizierungsmethoden
- Umgebungsvariablen
- Fehlerbehebung bei der Authentifizierung
- Details zur Authentifizierungsimplementierung
- Verfügbare Tools
- Beitragen
- Sternengeschichte
- Lizenz
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis 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 DevOpsLast updated -9618TypeScriptMIT License
- -security-license-qualityA 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 -202TypeScript
- -securityFlicense-qualityA 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 -3TypeScript
- AsecurityAlicenseAqualityA 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 -916PythonMIT License
Appeared in Searches
- A server for information about Jenkins (automation server)
- A system for monitoring and operating terminals
- Azure DevOps and Azure Repos Integration for Developer Workflows
- A platform for hosting and collaborating on software projects
- A tool or assistant to review and suggest changes for GitHub pull requests