Individueller MCP-Server für die Verwaltung von GitHub Issues - n8n-Workflow

• Entwickler- und DevOps-Teams, die KI-Agenten in die Ticketverfolgung integrieren möchten.


• Anwender, die eine sichere, granulare Kontrolle über den KI-Zugriff auf ihre GitHub-Repositories wünschen.


• n8n-Nutzer, die eigene KI-Tools mithilfe der n8n-Workflow-Logik erstellen möchten.

Dieser spezialisierte n8n-Workflow demonstriert, wie Sie Ihren eigenen benutzerdefinierten GitHub MCP-Server erstellen. Anstatt sich auf einen generischen Server zu verlassen, können Sie mit dieser n8n-Vorlage präzise Zugriffsrechte und Funktionen für Ihre KI-Agenten (wie Claude oder andere MCP-Clients) definieren. Das Kernversprechen liegt in der erhöhten Sicherheit und Anpassbarkeit, wodurch sichergestellt wird, dass der Agent nur spezifische, abgesicherte Operationen auf ausgewählten GitHub-Repositories durchführt. Durch die Verwendung von n8n zur Verwaltung der Logik können Sie diese Basis einfach erweitern, um Interaktionen mit Pull Requests einzubeziehen, Berichte zu erstellen oder die Ausgabe struktur anzupassen. Dieser Ansatz nutzt die Leistungsfähigkeit des n8n-Knoten-Ökosystems, um robuste KI-gestützte Lösungen zu schaffen.

Die gesamte Automatisierung wird durch einen spezialisierten n8n-Trigger initiiert: den 'Github MCP Server'-Knoten. Dieser n8n-Trigger wartet auf Befehle von einem kompatiblen MCP-Client (wie einem KI-Agenten). Es werden drei dedizierte 'Tool Workflow'-Knoten definiert, die spezifische GitHub-Aktionen für den Agenten aufrufbar machen: 'Get Latest Issues', 'Get Issue Comments' und 'Add Issue Comment'.

1. Tool-Aufruf: Wenn ein KI-Agent eines dieser Tools aufruft, führt der Befehl den n8n-Knoten 'When Executed by Another Workflow' aus und übergibt Parameter wie operation, repo und issueNumber.


2. Weiterleitung (Routing): Ein 'Switch'-n8n-Knoten namens 'Operation' prüft den operation-Parameter, um den Ablauf zur korrekten Aufgaben-Verzweigung zu leiten.


3. Aufgabenausführung:

Diese Struktur gewährleistet eine saubere, modulare Ausführung, bei der der n8n-Workflow alle Interaktionen mit der zugrundeliegenden GitHub-API sicher abwickelt.

Um diesen robusten n8n-Workflow zu installieren, gehen Sie wie folgt vor:

1. n8n-Workflow importieren: Kopieren Sie die bereitgestellten JSON-Daten und navigieren Sie zu Ihrer n8n-Instanz. Wählen Sie 'Workflows' > 'Neu' > 'Aus JSON importieren' und fügen Sie den Code ein.


2. GitHub-Anmeldeinformationen einrichten: Diese n8n-Vorlage erfordert gültige GitHub API-Anmeldeinformationen. Sie müssen eine Anmeldeinformationsressource einrichten, die der GitHub n8n-Knoten zur Authentifizierung bei der API verwenden kann. Stellen Sie sicher, dass dieses Konto die erforderlichen Lese- und Schreibberechtigungen für das Ziel-Repository besitzt (z. B. 'n8n-io/n8n', das in der Standardkonfiguration verwendet wird).


3. MCP-Server n8n-Trigger konfigurieren: Aktivieren Sie den 'Github MCP Server'-n8n-Trigger. Bevor Sie in die Produktion gehen, wird dringend empfohlen (wie im Haftnotiz vermerkt), die Authentifizierung für diesen n8n-Trigger aus Sicherheitsgründen zu aktivieren.


4. Client verbinden: Verwenden Sie die vom MCP Server n8n-Trigger generierte Endpunkt-URL, um Ihren bevorzugten MCP-Client (wie Claude Desktop) zu verbinden und Abfragen zu testen, wie z. B.: 'Kannst du mir die neuesten Issues zu MCP holen?'.

Github MCP Server (n8n-Trigger): Der Startpunkt für den gesamten n8n-Workflow. Er fungiert als API-Endpunkt und wartet über das Model Context Protocol auf strukturierte Befehle eines KI-Agenten.
Tool Workflow (n8n-Knoten): Es sind drei separate 'Tool Workflow'-Knoten konfiguriert ('Get Latest Issues', 'Get Issue Comments', 'Add Issue Comment'). Diese fassen die komplexen GitHub-Aktionen in einfache, beschreibende Tools zusammen, die der KI-Agent intelligent aufrufen kann. Sie definieren die erforderlichen Eingaben (z. B. issueNumber, text).
When Executed by Another Workflow (n8n-Knoten): Dieser fungiert als interner Einstiegspunkt, wenn ein 'Tool Workflow' dieselbe n8n-Workflow-Instanz zurückruft und die vom Agenten übergebenen Eingaben empfängt.
Operation (Switch n8n-Knoten): Wesentliche Ablaufsteuerung. Dieser n8n-Knoten leitet die eingehende Anfrage dynamisch basierend auf dem operation-Parameter (getLatestIssues, getIssueComments, addIssueComment) zur korrekten nachfolgenden GitHub-Aktionsverzweigung.
GitHub (n8n-Knoten): Wird in allen Verzweigungen für Kernoperationen verwendet: 'Get Many Issues' (um neueste Issues zu finden), 'Get Single Issue' (um das Abrufen von Kommentaren zu starten) und 'Create Comment' (um auf Issues zu antworten). Die Konfiguration nutzt Ausdrücke, um Repository- und Issue-Nummern aus den eingehenden Daten abzurufen.
HTTP Request (n8n-Knoten): Wird speziell im getIssueComments-Flow verwendet, um Kommentare über die in der ursprünglichen Issue-Nutzlast angegebene dedizierte URL abzurufen, was einen authentifizierten Zugriff erfordert.

• Set (n8n-Knoten): Wird intensiv genutzt (z. B. 'Simplify Issues', 'Simplify Comments'), um die vom GitHub n8n-Knoten zurückgegebenen Daten zu bereinigen und zu strukturieren, damit die endgültige Ausgabe prägnant und für den KI-Agenten relevant ist.