⚡ 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
- ✅ Usare 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 (registrazione gratuita disponibile)
- VS Code con estensioni AI Toolkit e GitHub Copilot installate
- Git CLI installato e configurato
Come sviluppatori, usiamo spesso GitHub per clonare repository e aprirli in VS Code o VS Code Insiders. Questo processo manuale prevede:
- Aprire il terminale o prompt dei comandi
- Navigare nella directory desiderata
- Eseguire il comando
git clone - Aprire VS Code nella directory 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 di Repository | Clona repo GitHub con validazione | Controllo automatico degli errori |
| 📁 Gestione Intelligente delle Directory | Verifica e crea directory in modo sicuro | Evita sovrascritture accidentali |
| 🚀 Integrazione Cross-Platform con VS Code | Apre progetti in VS Code/Insiders | Transizione fluida nel flusso di lavoro |
| 🛡️ 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 agent 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 la massima flessibilità
- Nome Server:
git_mcp_server
- Apri GitHub Copilot in VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Seleziona il modello Agent nell’interfaccia Copilot
- Scegli il modello Claude 3.7 per capacità di ragionamento avanzate
- Abilita l’integrazione MCP per l’accesso agli strumenti
💡 Consiglio Pro: Claude 3.7 offre una comprensione superiore dei flussi di lavoro di sviluppo e dei modelli di gestione degli errori.
Usa il seguente prompt dettagliato 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 agent 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 repository GitHub dimostra la potenza di MCP per automatizzare e migliorare la produttività degli sviluppatori.
- ✅ Sviluppatore MCP - Creato un server MCP personalizzato
- ✅ Automatizzatore di Flussi di Lavoro - 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 fatto molta strada, partendo dalla comprensione dei concetti base di AI Toolkit fino a costruire 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 agent AI.
Modulo 2: Hai imparato l’architettura MCP, integrato Playwright MCP e costruito il tuo primo agent di automazione browser.
Modulo 3: Sei passato allo 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 alla distribuzione in produzione
- ✅ Sviluppo Personalizzato: Costruzione, test e distribuzione di server MCP propri
- ✅ Applicazioni Pratiche: Risoluzione di sfide reali di flusso di lavoro con l’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 aziendali
- Contribuisci all’Open Source: Aiuta a migliorare gli strumenti e la documentazione MCP
Ricorda, questo workshop è solo l’inizio. L’ecosistema Model Context Protocol si evolve rapidamente e ora sei pronto a essere in prima linea negli strumenti di sviluppo potenziati dall’AI.
Grazie per la tua partecipazione e la dedizione all’apprendimento!
Speriamo che questo workshop abbia acceso 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 automatica Co-op Translator. Pur impegnandoci per garantire l’accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un umano. Non ci assumiamo alcuna responsabilità per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.