wehub-resource-sync🐙 Modul 4: Praktische MCP-Entwicklung – Benutzerdefinierter GitHub-Clone-Server
⚡ Schnellstart: Erstellen Sie in nur 30 Minuten einen produktionsreifen MCP-Server, der das Klonen von GitHub-Repositories und die VS Code-Integration automatisiert!
🎯 Lernziele
Am Ende dieses Labs werden Sie in der Lage sein:
- ✅ Einen benutzerdefinierten MCP-Server für reale Entwicklungs-Workflows zu erstellen
- ✅ GitHub-Repository-Klonfunktionalität über MCP zu implementieren
- ✅ Benutzerdefinierte MCP-Server mit VS Code und Agent Builder zu integrieren
- ✅ Den GitHub Copilot Agent Mode mit benutzerdefinierten MCP-Tools zu verwenden
- ✅ Benutzerdefinierte MCP-Server in Produktionsumgebungen zu testen und bereitzustellen
📋 Voraussetzungen
- Abschluss der Labs 1–3 (MCP-Grundlagen und fortgeschrittene Entwicklung)
- GitHub Copilot-Abonnement (kostenlose Anmeldung verfügbar)
- VS Code mit Microsoft Foundry Toolkit- und GitHub Copilot-Erweiterungen
- Git-CLI installiert und konfiguriert
🏗️ Projektübersicht
Reale Entwicklungsherausforderung
Als Entwickler verwenden wir häufig GitHub, um Repositories zu klonen und in VS Code oder VS Code Insiders zu öffnen. Dieser manuelle Prozess umfasst:
- Öffnen des Terminals/der Eingabeaufforderung
- Navigieren zum gewünschten Verzeichnis
- Ausführen des Befehls
git clone - Öffnen von VS Code im geklonten Verzeichnis
Unsere MCP-Lösung fasst dies in einem einzigen intelligenten Befehl zusammen!
Was Sie bauen werden
Ein GitHub Clone MCP Server (git_mcp_server), der bietet:
| Funktion | Beschreibung | Vorteil |
|---|---|---|
| 🔄 Intelligentes Repository-Klonen | Klonen von GitHub-Repos mit Validierung | Automatisierte Fehlerüberprüfung |
| 📁 Intelligente Verzeichnisverwaltung | Sichere Überprüfung und Erstellung von Verzeichnissen | Verhindert Überschreiben |
| 🚀 Plattformübergreifende VS Code-Integration | Öffnet Projekte in VS Code/Insiders | Nahtloser Workflow-Wechsel |
| 🛡️ Robuste Fehlerbehandlung | Umgang mit Netzwerk-, Berechtigungs- und Pfadproblemen | Produktionsreife Zuverlässigkeit |
📖 Schritt-für-Schritt-Implementierung
Schritt 1: Erstellen Sie den GitHub-Agenten im Agent Builder
-
Starten Sie den Agent Builder über die Microsoft Foundry Toolkit-Erweiterung
-
Erstellen Sie einen neuen Agenten mit der folgenden Konfiguration:
Agent Name: GitHubAgent -
Initialisieren Sie den benutzerdefinierten MCP-Server:
- Navigieren Sie zu Werkzeuge → Werkzeug hinzufügen → MCP Server
- Wählen Sie "Einen neuen MCP-Server erstellen"
- Wählen Sie die Python-Vorlage für maximale Flexibilität
- Servername:
git_mcp_server
Schritt 2: Konfigurieren Sie den GitHub Copilot Agent Mode
- Öffnen Sie GitHub Copilot in VS Code (Strg/Cmd + Shift + P → „GitHub Copilot: Öffnen“)
- Wählen Sie das Agent-Modell in der Copilot-Oberfläche
- Wählen Sie das Claude 3.7 Modell für erweiterte Reasoning-Fähigkeiten
- Aktivieren Sie die MCP-Integration für den Werkzeugzugriff
💡 Profi-Tipp: Claude 3.7 bietet ein überlegenes Verständnis von Entwicklungs-Workflows und Fehlerbehandlungsmustern.
Schritt 3: Implementieren Sie die Kernfunktionalität des MCP-Servers
Verwenden Sie das folgende detaillierte Prompt mit dem GitHub Copilot Agent Mode:
Create two MCP tools with the following comprehensive requirements:
🔧 TOOL A: clone_repository
Requirements:
- Clone any GitHub repository to a specified local folder
- Return the absolute path of the successfully cloned project
- Implement comprehensive validation:
✓ Check if target directory already exists (return error if exists)
✓ Validate GitHub URL format (https://github.com/user/repo)
✓ Verify git command availability (prompt installation if missing)
✓ Handle network connectivity issues
✓ Provide clear error messages for all failure scenarios
🚀 TOOL B: open_in_vscode
Requirements:
- Open specified folder in VS Code or VS Code Insiders
- Cross-platform compatibility (Windows/Linux/macOS)
- Use direct application launch (not terminal commands)
- Auto-detect available VS Code installations
- Handle cases where VS Code is not installed
- Provide user-friendly error messages
Additional Requirements:
- Follow MCP 1.9.3 best practices
- Include proper type hints and documentation
- Implement logging for debugging purposes
- Add input validation for all parameters
- Include comprehensive error handling
Schritt 4: Testen Sie Ihren MCP-Server
4a. Test im Agent Builder
- Starten Sie die Debug-Konfiguration für den Agent Builder
- Konfigurieren Sie Ihren Agenten mit folgendem System-Prompt:
SYSTEM_PROMPT:
You are my intelligent coding repository assistant. You help developers efficiently clone GitHub repositories and set up their development environment. Always provide clear feedback about operations and handle errors gracefully.
- Testen Sie mit realistischen Benutzerszenarien:
USER_PROMPT EXAMPLES:
Scenario : Basic Clone and Open
"Clone {Your GitHub Repo link such as https://github.com/kinfey/GHCAgentWorkshop
} and save to {The global path you specify}, then open it with VS Code Insiders"
Erwartete Ergebnisse:
- ✅ Erfolgreiches Klonen mit Pfadbestätigung
- ✅ Automatischer Start von VS Code
- ✅ Klare Fehlermeldungen bei ungültigen Szenarien
- ✅ Korrekte Behandlung von Grenzfällen
4b. Test im MCP Inspector
🎉 Herzlichen Glückwunsch! Sie haben erfolgreich einen praktischen, produktionsreifen MCP-Server erstellt, der reale Entwicklungs-Workflow-Herausforderungen löst. Ihr benutzerdefinierter GitHub-Clone-Server demonstriert die Leistungsfähigkeit von MCP zur Automatisierung und Verbesserung der Entwicklerproduktivität.
🏆 Errungenschaft freigeschaltet:
- ✅ MCP-Entwickler – Benutzerdefinierter MCP-Server erstellt
- ✅ Workflow-Automatisierer – Entwicklungsprozesse optimiert
- ✅ Integrations-Experte – Mehrere Entwicklungstools verbunden
- ✅ Produktionsbereit – Bereitstellbare Lösungen entwickelt
🎓 Workshop-Abschluss: Ihre Reise mit Model Context Protocol
Liebe Workshop-Teilnehmerin, lieber Workshop-Teilnehmer,
herzlichen Glückwunsch zum Abschluss aller vier Module des Model Context Protocol Workshops! Sie haben einen weiten Weg von den Grundlagen des Microsoft Foundry Toolkits bis hin zum Bau produktionsreifer MCP-Server zurückgelegt, die reale Entwicklungsprobleme lösen.
🚀 Rückblick auf Ihren Lernpfad:
Modul 1: Sie haben mit den Grundlagen des Microsoft Foundry Toolkits, dem Testen von Modellen und der Erstellung Ihres ersten KI-Agenten begonnen.
Modul 2: Sie haben die MCP-Architektur kennengelernt, Playwright MCP integriert und Ihren ersten Browser-Automatisierungsagenten gebaut.
Modul 3: Sie sind in die benutzerdefinierte MCP-Server-Entwicklung mit dem Weather MCP Server eingestiegen und haben Debugging-Tools gemeistert.
Modul 4: Nun haben Sie all das angewandt, um ein praktisches Automatisierungstool für GitHub-Repository-Workflows zu erstellen.
🌟 Was Sie gemeistert haben:
- ✅ Microsoft Foundry Toolkit-Ökosystem: Modelle, Agenten und Integrationsmuster
- ✅ MCP-Architektur: Client-Server-Design, Transportprotokolle und Sicherheit
- ✅ Entwicklertools: Vom Playground über Inspector bis zur Produktionsbereitstellung
- ✅ Benutzerdefinierte Entwicklung: Erstellen, Testen und Bereitstellen eigener MCP-Server
- ✅ Praxisanwendungen: Lösung realer Workflow-Herausforderungen mit KI
🔮 Ihre nächsten Schritte:
- Erstellen Sie Ihren eigenen MCP-Server: Wenden Sie das Gelernte an, um Ihre individuellen Workflows zu automatisieren
- Treten Sie der MCP-Community bei: Teilen Sie Ihre Kreationen und lernen Sie von anderen
- Erkunden Sie erweiterte Integrationen: Verbinden Sie MCP-Server mit Unternehmenssystemen
- Engagieren Sie sich im Open Source: Helfen Sie mit, MCP-Tools und Dokumentation zu verbessern
Denken Sie daran: Dieser Workshop ist erst der Anfang. Das Model Context Protocol-Ökosystem entwickelt sich schnell weiter, und Sie sind nun bestens gerüstet, um an der Spitze KI-gestützter Entwicklungstools zu stehen.
Vielen Dank für Ihre Teilnahme und Ihr Engagement beim Lernen!
Wir hoffen, dieser Workshop hat Ideen geweckt, die Ihre Art und Weise, KI-Tools in Ihrem Entwicklungsprozess zu nutzen, nachhaltig verändern.
Viel Erfolg beim Programmieren!
Wie geht es weiter
Herzlichen Glückwunsch zum Abschluss aller Labs in Modul 10!
- Zurück zu: Modul 10 Übersicht
- Weiter zu: Modul 11: MCP Server Hands-On Labs
Haftungsausschluss: Dieses Dokument wurde mit dem KI-Übersetzungsdienst Co-op Translator übersetzt. Obwohl wir uns um Genauigkeit bemühen, beachten Sie bitte, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner Ursprungssprache gilt als maßgebliche Quelle. Bei kritischen Informationen wird eine professionelle menschliche Übersetzung empfohlen. Wir übernehmen keine Haftung für Missverständnisse oder Fehlinterpretationen, die aus der Verwendung dieser Übersetzung entstehen.