🐙 Module 4 : DĂ©veloppement MCP Pratique - Serveur personnalisĂ© de clonage GitHub

February 9, 2026 · View on GitHub

Duration Difficulty MCP VS Code GitHub Copilot

⚡ DĂ©marrage rapide : Construisez un serveur MCP prĂȘt pour la production qui automatise le clonage de dĂ©pĂŽts GitHub et l’intĂ©gration VS Code en seulement 30 minutes !

🎯 Objectifs d'apprentissage

À la fin de ce laboratoire, vous serez capable de :

  • ✅ CrĂ©er un serveur MCP personnalisĂ© pour des workflows de dĂ©veloppement rĂ©els
  • ✅ ImplĂ©menter la fonctionnalitĂ© de clonage de dĂ©pĂŽts GitHub via MCP
  • ✅ IntĂ©grer des serveurs MCP personnalisĂ©s avec VS Code et Agent Builder
  • ✅ Utiliser le mode Agent de GitHub Copilot avec des outils MCP personnalisĂ©s
  • ✅ Tester et dĂ©ployer des serveurs MCP personnalisĂ©s en environnements de production

📋 PrĂ©requis

  • Avoir terminĂ© les laboratoires 1 Ă  3 (fondamentaux MCP et dĂ©veloppement avancĂ©)
  • Abonnement GitHub Copilot (inscription gratuite disponible)
  • VS Code avec les extensions AI Toolkit et GitHub Copilot installĂ©es
  • CLI Git installĂ©e et configurĂ©e

đŸ—ïž PrĂ©sentation du projet

Défi de développement réel

En tant que développeurs, nous utilisons fréquemment GitHub pour cloner des dépÎts et les ouvrir dans VS Code ou VS Code Insiders. Ce processus manuel consiste à :

  1. Ouvrir un terminal ou un invite de commandes
  2. Se déplacer vers le répertoire désiré
  3. Exécuter la commande git clone
  4. Ouvrir VS Code dans le répertoire cloné

Notre solution MCP simplifie tout cela en une seule commande intelligente !

Ce que vous allez construire

Un serveur MCP GitHub Clone (git_mcp_server) qui offre :

FonctionnalitéDescriptionAvantage
🔄 Clonage intelligent de dĂ©pĂŽtsCloner des dĂ©pĂŽts GitHub avec validationVĂ©rification automatique des erreurs
📁 Gestion intelligente des rĂ©pertoiresVĂ©rifier et crĂ©er des rĂ©pertoires en toute sĂ©curitéÉvite les Ă©crasements
🚀 IntĂ©gration multiplateforme VS CodeOuvrir des projets dans VS Code/InsidersTransition fluide du workflow
đŸ›Ąïž Gestion robuste des erreursGĂ©rer les problĂšmes rĂ©seau, permissions et cheminsFiabilitĂ© prĂȘte pour la production

📖 Mise en Ɠuvre Ă©tape par Ă©tape

Étape 1 : CrĂ©er un agent GitHub dans Agent Builder

  1. Lancez Agent Builder via l’extension AI Toolkit

  2. Créez un nouvel agent avec la configuration suivante :

    Agent Name: GitHubAgent
    
  3. Initialisez le serveur MCP personnalisé :

    • Allez dans Outils → Ajouter un outil → Serveur MCP
    • SĂ©lectionnez « CrĂ©er un nouveau serveur MCP »
    • Choisissez modĂšle Python pour une flexibilitĂ© maximale
    • Nom du serveur : git_mcp_server

Étape 2 : Configurer le Mode Agent GitHub Copilot

  1. Ouvrez GitHub Copilot dans VS Code (Ctrl/Cmd + Maj + P → « GitHub Copilot : Ouvrir »)
  2. SĂ©lectionnez le modĂšle Agent dans l’interface Copilot
  3. Choisissez le modÚle Claude 3.7 pour des capacités de raisonnement améliorées
  4. Activez l’intĂ©gration MCP pour l’accĂšs aux outils

💡 Astuce pro : Claude 3.7 offre une meilleure comprĂ©hension des workflows de dĂ©veloppement et des schĂ©mas de gestion des erreurs.

Étape 3 : ImplĂ©menter la fonctionnalitĂ© principale du serveur MCP

Utilisez la commande détaillée suivante avec le mode Agent GitHub Copilot :

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

Étape 4 : Testez votre serveur MCP

4a. Test dans Agent Builder

  1. Lancez la configuration de débogage dans Agent Builder
  2. Configurez votre agent avec cette invite systĂšme :
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.
  1. Testez avec des scénarios utilisateurs réalistes :
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"

Agent Builder Testing

Résultats attendus :

  • ✅ Clonage rĂ©ussi avec confirmation du chemin
  • ✅ Lancement automatique de VS Code
  • ✅ Messages d’erreur clairs pour les scĂ©narios invalides
  • ✅ Gestion correcte des cas limites

4b. Test dans MCP Inspector

MCP Inspector Testing


🎉 FĂ©licitations ! Vous avez créé avec succĂšs un serveur MCP pratique prĂȘt pour la production qui rĂšgle des problĂšmes rĂ©els de workflow de dĂ©veloppement. Votre serveur personnalisĂ© de clonage GitHub dĂ©montre la puissance du MCP pour automatiser et amĂ©liorer la productivitĂ© des dĂ©veloppeurs.

🏆 SuccĂšs dĂ©bloquĂ© :

  • ✅ DĂ©veloppeur MCP - Serveur MCP personnalisĂ© créé
  • ✅ Automatiseur de workflows - Processus de dĂ©veloppement simplifiĂ©s
  • ✅ Expert en intĂ©gration - Connexion de multiples outils de dĂ©veloppement
  • ✅ PrĂȘt pour la production - Solutions dĂ©ployables construites

🎓 Fin de l’atelier : Votre parcours avec le Model Context Protocol

Cher participant à l’atelier,

FĂ©licitations pour avoir terminĂ© les quatre modules de l’atelier Model Context Protocol ! Vous avez parcouru un long chemin, depuis la comprĂ©hension des concepts fondamentaux de AI Toolkit jusqu’à la crĂ©ation de serveurs MCP prĂȘts pour la production qui rĂ©solvent des dĂ©fis rĂ©els de dĂ©veloppement.

🚀 RĂ©capitulatif de votre parcours d’apprentissage :

Module 1 : Vous avez commencĂ© par explorer les fondamentaux d’AI Toolkit, le test de modĂšles et la crĂ©ation de votre premier agent IA.

Module 2 : Vous avez appris l’architecture MCP, intĂ©grĂ© Playwright MCP et construit votre premier agent d’automatisation de navigateur.

Module 3 : Vous ĂȘtes passĂ© au dĂ©veloppement de serveurs MCP personnalisĂ©s avec le serveur MCP MĂ©tĂ©o et maĂźtrisĂ© les outils de dĂ©bogage.

Module 4 : Vous avez dĂ©sormais appliquĂ© tout cela pour crĂ©er un outil pratique d’automatisation des workflows de dĂ©pĂŽts GitHub.

🌟 Ce que vous avez maĂźtrisĂ© :

  • ✅ ÉcosystĂšme AI Toolkit : ModĂšles, agents, et schĂ©mas d’intĂ©gration
  • ✅ Architecture MCP : Conception client-serveur, protocoles de transport et sĂ©curitĂ©
  • ✅ Outils dĂ©veloppeurs : De Playground Ă  Inspector jusqu’au dĂ©ploiement en production
  • ✅ DĂ©veloppement personnalisĂ© : Construction, test et dĂ©ploiement de vos propres serveurs MCP
  • ✅ Applications pratiques : RĂ©soudre des dĂ©fis rĂ©els de workflows avec l’IA

🔼 Vos prochaines Ă©tapes :

  1. Construisez votre propre serveur MCP : Appliquez ces compétences pour automatiser vos workflows uniques
  2. Rejoignez la communauté MCP : Partagez vos créations et apprenez des autres
  3. Explorez l’intĂ©gration avancĂ©e : Connectez les serveurs MCP aux systĂšmes d’entreprise
  4. Contribuez Ă  l’open source : Aidez Ă  amĂ©liorer les outils et la documentation MCP

Rappelez-vous, cet atelier n’est que le dĂ©but. L’écosystĂšme Model Context Protocol Ă©volue rapidement et vous ĂȘtes dĂ©sormais prĂȘt Ă  ĂȘtre Ă  l’avant-garde des outils de dĂ©veloppement assistĂ©s par IA.

Merci pour votre participation et votre engagement dans l’apprentissage !

Nous espĂ©rons que cet atelier a suscitĂ© des idĂ©es qui transformeront votre maniĂšre de construire et d’interagir avec les outils IA dans votre parcours de dĂ©veloppement.

Bon codage !


Et ensuite

Félicitations pour avoir terminé tous les laboratoires du Module 10 !


Clause de non-responsabilité :
Ce document a Ă©tĂ© traduit Ă  l’aide du service de traduction automatisĂ©e Co-op Translator. Bien que nous nous efforcions d’assurer l’exactitude, veuillez noter que les traductions automatiques peuvent comporter des erreurs ou des inexactitudes. Le document original dans sa langue d’origine doit ĂȘtre considĂ©rĂ© comme la source faisant foi. Pour les informations critiques, il est recommandĂ© de recourir Ă  une traduction professionnelle humaine. Nous dĂ©clinons toute responsabilitĂ© en cas de malentendus ou d’interprĂ©tations erronĂ©es rĂ©sultant de l’utilisation de cette traduction.