⚡ Avvio rapido: Costruisci un server MCP pronto per la produzione che automatizza il cloning di repository GitHub e l’integrazione con VS Code in soli 30 minuti!
Al termine di questo laboratorio sarai in grado di:
- ✅ Creare un server MCP personalizzato per flussi di lavoro di sviluppo reali
- ✅ Implementare la funzionalità di clonazione di repository GitHub tramite MCP
- ✅ Integrare server MCP personalizzati con VS Code e Agent Builder
- ✅ Utilizzare GitHub Copilot Agent Mode con strumenti MCP personalizzati
- ✅ Testare e distribuire server MCP personalizzati in ambienti di produzione
- Completamento dei laboratori 1-3 (fondamenti MCP e sviluppo avanzato)
- Abbonamento a GitHub Copilot (iscrizione gratuita disponibile)
- VS Code con estensioni AI Toolkit e GitHub Copilot
- Git CLI installato e configurato
Come sviluppatori, spesso usiamo GitHub per clonare repository e aprirli in VS Code o VS Code Insiders. Questo processo manuale prevede:
- Aprire terminale o prompt dei comandi
- Navigare nella directory desiderata
- Eseguire il comando
git clone - Aprire VS Code nella cartella clonata
La nostra soluzione MCP semplifica tutto in un unico comando intelligente!
Un GitHub Clone MCP Server (git_mcp_server) che offre:
| Funzionalità | Descrizione | Vantaggio |
|---|---|---|
| 🔄 Clonazione Intelligente dei Repository | Clona repo GitHub con validazione | Controllo automatico degli errori |
| 📁 Gestione Intelligente delle Directory | Verifica e crea cartelle in sicurezza | Evita sovrascritture accidentali |
| 🚀 Integrazione Cross-Platform con VS Code | Apre progetti in VS Code/Insiders | Passaggio fluido nel workflow |
| 🛡️ Gestione Robusta degli Errori | Gestisce problemi di rete, permessi e percorsi | Affidabilità pronta per la produzione |
-
Avvia Agent Builder tramite l’estensione AI Toolkit
-
Crea un nuovo agente con la seguente configurazione:
Agent Name: GitHubAgent -
Inizializza il server MCP personalizzato:
- Vai su Tools → Add Tool → MCP Server
- Seleziona "Create A new MCP Server"
- Scegli il template Python per massima flessibilità
- Nome Server:
git_mcp_server
- Apri GitHub Copilot in VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Seleziona Agent Model nell’interfaccia Copilot
- Scegli il modello Claude 3.7 per capacità di ragionamento avanzate
- Abilita l’integrazione MCP per l’accesso agli strumenti
💡 Consiglio da esperti: Claude 3.7 offre una comprensione superiore dei flussi di lavoro di sviluppo e dei modelli di gestione degli errori.
Usa il prompt dettagliato seguente con 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
- Avvia la configurazione di debug per Agent Builder
- Configura il tuo agente con questo prompt di sistema:
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.
- Testa con scenari utente realistici:
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"
Risultati Attesi:
- ✅ Clonazione riuscita con conferma del percorso
- ✅ Avvio automatico di VS Code
- ✅ Messaggi di errore chiari per scenari non validi
- ✅ Gestione corretta dei casi limite
🎉 Congratulazioni! Hai creato con successo un server MCP pratico e pronto per la produzione che risolve sfide reali nei flussi di lavoro di sviluppo. Il tuo server personalizzato per clonare GitHub dimostra la potenza di MCP per automatizzare e migliorare la produttività degli sviluppatori.
- ✅ Sviluppatore MCP - Creato un server MCP personalizzato
- ✅ Automazione Workflow - Ottimizzato i processi di sviluppo
- ✅ Esperto di Integrazione - Collegato più strumenti di sviluppo
- ✅ Pronto per la Produzione - Realizzato soluzioni distribuibili
Caro Partecipante al Workshop,
Congratulazioni per aver completato tutti e quattro i moduli del workshop sul Model Context Protocol! Hai percorso molta strada, dalla comprensione dei concetti base di AI Toolkit fino alla creazione di server MCP pronti per la produzione che risolvono sfide reali di sviluppo.
Modulo 1: Hai iniziato esplorando i fondamenti di AI Toolkit, testando modelli e creando il tuo primo agente AI.
Modulo 2: Hai appreso l’architettura MCP, integrato Playwright MCP e costruito il tuo primo agente di automazione browser.
Modulo 3: Hai avanzato nello sviluppo di server MCP personalizzati con il Weather MCP server e hai padroneggiato gli strumenti di debug.
Modulo 4: Ora hai applicato tutto per creare uno strumento pratico di automazione del flusso di lavoro con repository GitHub.
- ✅ Ecosistema AI Toolkit: Modelli, agenti e pattern di integrazione
- ✅ Architettura MCP: Design client-server, protocolli di trasporto e sicurezza
- ✅ Strumenti per Sviluppatori: Dal Playground all’Inspector fino al deployment in produzione
- ✅ Sviluppo Personalizzato: Costruzione, test e distribuzione di server MCP
- ✅ Applicazioni Pratiche: Risoluzione di sfide reali di workflow con AI
- Costruisci il Tuo Server MCP: Applica queste competenze per automatizzare i tuoi flussi di lavoro unici
- Unisciti alla Comunità MCP: Condividi le tue creazioni e impara dagli altri
- Esplora Integrazioni Avanzate: Collega server MCP a sistemi enterprise
- Contribuisci all’Open Source: Aiuta a migliorare gli strumenti e la documentazione MCP
Ricorda, questo workshop è solo l’inizio. L’ecosistema Model Context Protocol evolve rapidamente e ora sei pronto a essere in prima linea negli strumenti di sviluppo potenziati dall’AI.
Grazie per la tua partecipazione e per l’impegno nell’apprendimento!
Speriamo che questo workshop abbia stimolato idee che trasformeranno il modo in cui costruisci e interagisci con gli strumenti AI nel tuo percorso di sviluppo.
Buona programmazione!
Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda la traduzione professionale umana. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.