Segui questi passaggi per iniziare a utilizzare queste risorse:
- Fai il Fork del Repository: Clicca
- Clona il Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git
- Unisciti al Discord di Azure AI Foundry e incontra esperti e altri sviluppatori
🌐 Supporto Multilingue
Supportato tramite GitHub Action (Automatizzato e Sempre Aggiornato)
Arabo | Bengalese | Bulgaro | Birmano (Myanmar) | Cinese (Semplificato) | Cinese (Tradizionale, Hong Kong) | Cinese (Tradizionale, Macao) | Cinese (Tradizionale, Taiwan) | Croato | Ceco | Danese | Olandese | Finlandese | Francese | Tedesco | Greco | Ebraico | Hindi | Ungherese | Indonesiano | Italiano | Giapponese | Coreano | Malese | Marathi | Nepalese | Norvegese | Persiano (Farsi) | Polacco | Portoghese (Brasile) | Portoghese (Portogallo) | Punjabi (Gurmukhi) | Rumeno | Russo | Serbo (Cirillico) | Slovacco | Sloveno | Spagnolo | Swahili | Svedese | Tagalog (Filippino) | Thailandese | Turco | Ucraino | Urdu | Vietnamita
🚀 Curriculum del Model Context Protocol (MCP) per Principianti
Impara MCP con esempi pratici di codice in C#, Java, JavaScript, Rust, Python e TypeScript
🧠 Panoramica del Curriculum del Model Context Protocol
Il Model Context Protocol (MCP) è un framework all’avanguardia progettato per standardizzare le interazioni tra modelli di intelligenza artificiale e applicazioni client. Questo curriculum open-source offre un percorso di apprendimento strutturato, completo di esempi pratici di codice e casi d’uso reali, in linguaggi di programmazione popolari come C#, Java, JavaScript, TypeScript e Python.
Che tu sia uno sviluppatore AI, un architetto di sistemi o un ingegnere del software, questa guida è una risorsa completa per padroneggiare i fondamenti e le strategie di implementazione di MCP.
🔗 Risorse Ufficiali MCP
- 📘 Documentazione MCP – Tutorial dettagliati e guide per gli utenti
- 📜 Specifiche MCP – Architettura del protocollo e riferimenti tecnici
- 📜 Specifiche Originali MCP – Riferimenti tecnici legacy (potrebbero contenere dettagli aggiuntivi)
- 🧑💻 Repository GitHub MCP – SDK open-source, strumenti e esempi di codice
- 🌐 Community MCP – Partecipa alle discussioni e contribuisci alla community
🧭 Panoramica del Curriculum MCP
📚 Struttura Completa del Curriculum
Modulo | Argomento | Descrizione | Link |
---|---|---|---|
Modulo 1-3: Fondamenti | |||
00 | Introduzione a MCP | Panoramica del Model Context Protocol e della sua importanza nei flussi di lavoro AI | Leggi di più |
01 | Concetti Chiave | Esplorazione approfondita dei concetti fondamentali di MCP | Leggi di più |
02 | Sicurezza in MCP | Minacce alla sicurezza e migliori pratiche | Leggi di più |
03 | Iniziare con MCP | Configurazione dell’ambiente, server/client di base, integrazione | Leggi di più |
Modulo 3: Creazione del Primo Server e Client | |||
3.1 | Primo Server | Crea il tuo primo server MCP | Guida |
3.2 | Primo Client | Sviluppa un client MCP di base | Guida |
3.3 | Client con LLM | Integra modelli di linguaggio di grandi dimensioni | Guida |
3.4 | Integrazione con VS Code | Consuma server MCP in VS Code | Guida |
3.5 | Server stdio | Crea server utilizzando il trasporto stdio | Guida |
3.6 | Streaming HTTP | Implementa lo streaming HTTP in MCP | Guida |
3.7 | Toolkit AI | Usa il Toolkit AI con MCP | Guida |
3.8 | Testing | Testa l’implementazione del tuo server MCP | Guida |
3.9 | Deployment | Distribuisci server MCP in produzione | Guida |
3.10 | Uso avanzato del server | Usa server avanzati per funzionalità avanzate e architetture migliorate | Guida |
3.11 | Autenticazione semplice | Un capitolo che mostra l’autenticazione dall’inizio e RBAC | Guida |
Modulo 4-5: Pratico e Avanzato | |||
04 | Implementazione Pratica | SDK, debug, test, modelli di prompt riutilizzabili | Leggi di più |
05 | Argomenti Avanzati in MCP | AI multi-modale, scalabilità, utilizzo aziendale | Leggi di più |
5.1 | Integrazione con Azure | Integrazione MCP con Azure | Guida |
5.2 | Multi-modalità | Lavorare con più modalità | Guida |
5.3 | Demo OAuth2 | Implementa l’autenticazione OAuth2 | Guida |
5.4 | Contesti Radice | Comprendi e implementa contesti radice | Guida |
5.5 | Routing | Strategie di routing MCP | Guida |
5.6 | Campionamento | Tecniche di campionamento in MCP | Guida |
5.7 | Scalabilità | Scala le implementazioni MCP | Guida |
5.8 | Sicurezza | Considerazioni avanzate sulla sicurezza | Guida |
5.9 | Ricerca Web | Implementa funzionalità di ricerca web | Guida |
5.10 | Streaming in tempo reale | Costruisci funzionalità di streaming in tempo reale | Guida |
5.11 | Ricerca in tempo reale | Implementa la ricerca in tempo reale | Guida |
5.12 | Autenticazione Entra ID | Autenticazione con Microsoft Entra ID | Guida |
5.13 | Integrazione Foundry | Integra con Azure AI Foundry | Guida |
5.14 | Ingegneria del Contesto | Tecniche per un’efficace ingegneria del contesto | Guida |
5.15 | Trasporto Personalizzato MCP | Implementazioni di trasporto personalizzato | Guida |
Modulo 6-10: Community e Migliori Pratiche | |||
06 | Contributi della Community | Come contribuire all’ecosistema MCP | Guida |
07 | Approfondimenti dall’Adozione Iniziale | Storie di implementazione nel mondo reale | Guida |
08 | Migliori Pratiche per MCP | Prestazioni, tolleranza ai guasti, resilienza | Guida |
09 | Studi di Caso MCP | Esempi pratici di implementazione | Guida |
10 | Workshop Pratico | Costruire un server MCP con AI Toolkit | Laboratorio |
Modulo 11: Laboratorio Pratico Server MCP | |||
11 | Integrazione del Database Server MCP | Percorso di apprendimento pratico completo di 13 laboratori per l’integrazione con PostgreSQL | Laboratori |
11.1 | Introduzione | Panoramica di MCP con integrazione del database e caso d’uso per analisi di vendita al dettaglio | Laboratorio 00 |
11.2 | Architettura Core | Comprendere l’architettura del server MCP, i livelli del database e i modelli di sicurezza | Lab 01 |
11.3 | Sicurezza e Multi-Tenancy | Sicurezza a livello di riga, autenticazione e accesso ai dati multi-tenant | Lab 02 |
11.4 | Configurazione dell’Ambiente | Configurazione dell’ambiente di sviluppo, Docker, risorse Azure | Lab 03 |
11.5 | Progettazione del Database | Configurazione di PostgreSQL, progettazione dello schema retail e dati di esempio | Lab 04 |
11.6 | Implementazione del Server MCP | Creazione del server FastMCP con integrazione del database | Lab 05 |
11.7 | Sviluppo di Strumenti | Creazione di strumenti per query al database e introspezione dello schema | Lab 06 |
11.8 | Ricerca Semantica | Implementazione di embedding vettoriali con Azure OpenAI e pgvector | Lab 07 |
11.9 | Test e Debugging | Strategie di test, strumenti di debugging e approcci di validazione | Lab 08 |
11.10 | Integrazione con VS Code | Configurazione dell’integrazione MCP con VS Code e utilizzo di AI Chat | Lab 09 |
11.11 | Strategie di Deployment | Deployment con Docker, Azure Container Apps e considerazioni sullo scaling | Lab 10 |
11.12 | Monitoraggio | Application Insights, logging e monitoraggio delle prestazioni | Lab 11 |
11.13 | Best Practices | Ottimizzazione delle prestazioni, rafforzamento della sicurezza e consigli per la produzione | Lab 12 |
💻 Progetti di Codice di Esempio
Esempi Base di Calcolatori MCP
Linguaggio | Descrizione | Link |
---|---|---|
C# | Esempio di Server MCP | Visualizza Codice |
Java | Calcolatore MCP | Visualizza Codice |
JavaScript | Demo MCP | Visualizza Codice |
Python | Server MCP | Visualizza Codice |
TypeScript | Esempio MCP | Visualizza Codice |
Rust | Esempio MCP | Visualizza Codice |
Implementazioni Avanzate di MCP
Linguaggio | Descrizione | Link |
---|---|---|
C# | Esempio Avanzato | Visualizza Codice |
Java con Spring | Esempio di App Container | Visualizza Codice |
JavaScript | Esempio Avanzato | Visualizza Codice |
Python | Implementazione Complessa | Visualizza Codice |
TypeScript | Esempio di Container | Visualizza Codice |
🎯 Prerequisiti per Imparare MCP
Per ottenere il massimo da questo curriculum, dovresti avere:
Conoscenza di base della programmazione in almeno uno dei seguenti linguaggi: C#, Java, JavaScript, Python o TypeScript
Comprensione del modello client-server e delle API
Familiarità con i concetti di REST e HTTP
(Opzionale) Background nei concetti di AI/ML
Partecipazione alle discussioni della nostra community per supporto
📚 Guida allo Studio e Risorse
Questo repository include diverse risorse per aiutarti a navigare e imparare efficacemente:
Guida allo Studio
Una Guida allo Studio completa è disponibile per aiutarti a navigare efficacemente in questo repository. La guida include:
- Una mappa visiva del curriculum che mostra tutti gli argomenti trattati
- Dettagliata suddivisione di ogni sezione del repository
- Indicazioni su come utilizzare i progetti di esempio
- Percorsi di apprendimento consigliati per diversi livelli di competenza
- Risorse aggiuntive per completare il tuo percorso di apprendimento
Changelog
Manteniamo un Changelog dettagliato che traccia tutti gli aggiornamenti significativi ai materiali del curriculum, inclusi:
- Aggiunte di nuovi contenuti
- Modifiche strutturali
- Miglioramenti delle funzionalità
- Aggiornamenti della documentazione
🛠️ Come Utilizzare Questo Curriculum in Modo Efficace
Ogni lezione in questa guida include:
- Spiegazioni chiare dei concetti MCP
- Esempi di codice live in più linguaggi
- Esercizi per costruire applicazioni MCP reali
- Risorse extra per studenti avanzati
Eventi
MCP Dev Days Luglio 2025
➡️Guarda On Demand - MCP Dev Days
Preparati a due giorni di approfondimenti tecnici, connessione con la community e apprendimento pratico durante i MCP Dev Days, un evento virtuale dedicato al Model Context Protocol (MCP) — lo standard emergente che collega i modelli AI agli strumenti su cui si basano. Puoi guardare i MCP Dev Days registrandoti sulla nostra pagina dell’evento: https://aka.ms/mcpdevdays.
Giorno 1: Produttività MCP, DevTools e Community:
È dedicato a potenziare gli sviluppatori nell’utilizzo di MCP nel loro flusso di lavoro e a celebrare la straordinaria community MCP. Saremo accompagnati da membri della community e partner come Arcade, Block, Okta e Neon per vedere come stanno collaborando con Microsoft per plasmare un ecosistema MCP aperto ed estensibile. Demo reali su VS Code, Visual Studio, GitHub Copilot e strumenti popolari della community Workflow pratici e contestualizzati per gli sviluppatori Sessioni e approfondimenti guidati dalla community Che tu stia iniziando con MCP o stia già costruendo con esso, il Giorno 1 offrirà ispirazione e spunti pratici.
Giorno 2: Costruire Server MCP con Fiducia
È dedicato ai costruttori MCP. Approfondiremo strategie di implementazione e best practices per creare server MCP e integrare MCP nei tuoi workflow AI.
Argomenti trattati:
- Creazione di Server MCP e loro integrazione nelle esperienze degli agenti
- Sviluppo guidato dai prompt
- Best practices di sicurezza
- Utilizzo di building blocks come Functions, ACA e API Management
- Allineamento del registro e strumenti (1P + 3P)
Se sei uno sviluppatore, un costruttore di strumenti o uno stratega di prodotti AI, questo giorno è ricco di approfondimenti per costruire soluzioni MCP scalabili, sicure e pronte per il futuro.
MCP Boot Camp Agosto 2025
Impara in sessioni video intensive come creare server MCP, integrare con VS Code e distribuire professionalmente su Azure basandoti sui contenuti del curriculum MCP per principianti. Acquisisci competenze pratiche in una tecnologia che le principali aziende stanno già utilizzando.
➡️Guarda On Demand MCP Bootcamp | Inglese
➡️Guarda On Demand MCP Bootcamp | Brasile
➡️Guarda On Demand MCP Bootcamp | Spagnolo
Impariamo MCP con C# - Serie di Tutorial
Impariamo il Model Context Protocol (MCP), un framework all’avanguardia progettato per standardizzare le interazioni tra modelli AI e applicazioni client. Attraverso questa sessione adatta ai principianti, ti introdurremo a MCP e ti guideremo nella creazione del tuo primo server MCP.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Ringraziamenti alla Community
Grazie al Microsoft Valued Professional Shivam Goyal per aver contribuito con importanti esempi di codice.
📜 Informazioni sulla Licenza
Questo contenuto è concesso sotto licenza MIT License. Per termini e condizioni, consulta il file LICENSE.
🤝 Linee Guida per le Contribuzioni
Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede di accettare un Contributor License Agreement (CLA) dichiarando che hai il diritto di, e effettivamente concedi, i diritti per utilizzare il tuo contributo. Per dettagli, visita https://cla.opensource.microsoft.com.
Quando invii una pull request, un bot CLA determinerà automaticamente se devi fornire un CLA e decorerà la PR di conseguenza (ad esempio, controllo dello stato, commento). Segui semplicemente le istruzioni fornite dal bot. Dovrai farlo solo una volta per tutti i repository che utilizzano il nostro CLA.
Questo progetto ha adottato il Microsoft Open Source Code of Conduct. Per ulteriori informazioni, consulta le FAQ sul Codice di Condotta o contatta opencode@microsoft.com per eventuali domande o commenti aggiuntivi.
📂 Struttura del Repository
Il repository è organizzato come segue:
- Core Curriculum (00-11): Contenuto principale organizzato in undici moduli sequenziali, inclusi laboratori completi di integrazione del database
- 11-MCPServerHandsOnLabs/: Percorso di apprendimento completo di 13 laboratori per costruire server MCP pronti per la produzione con integrazione PostgreSQL
- images/: Diagrammi e illustrazioni utilizzati nel curriculum
- translations/: Supporto multilingue con traduzioni automatiche
- translated_images/: Versioni localizzate di diagrammi e illustrazioni
- study_guide.md: Guida completa per navigare nel repository
- changelog.md: Registro di tutte le modifiche significative ai materiali del curriculum
- mcp.json: File di configurazione per la specifica MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documenti di governance del progetto
🎒 Altri Corsi
Il nostro team produce altri corsi! Dai un’occhiata:
- NUOVO Edge AI For Beginners
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Padroneggiare GitHub Copilot per sviluppatori C#/.NET
- Scegli la tua avventura con Copilot
™️ Avviso sui marchi registrati
Questo progetto potrebbe contenere marchi o loghi relativi a progetti, prodotti o servizi. L’uso autorizzato dei marchi o loghi Microsoft è soggetto e deve rispettare le Linee guida sui marchi e sul brand di Microsoft. L’uso dei marchi o loghi Microsoft in versioni modificate di questo progetto non deve causare confusione o implicare una sponsorizzazione da parte di Microsoft. Qualsiasi utilizzo di marchi o loghi di terze parti è soggetto alle politiche di tali terze parti.
Ottenere aiuto
Se ti trovi in difficoltà o hai domande sulla creazione di app AI, unisciti a:
Se hai feedback sui prodotti o riscontri errori durante la creazione, visita:
Clausola di esclusione della responsabilità:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Sebbene ci impegniamo per garantire l’accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall’uso di questa traduzione.