MCP-per-principianti

Collaboratori GitHub Problemi GitHub Pull Request GitHub PRs Welcome

Osservatori GitHub Fork GitHub Stelle GitHub

Microsoft Azure AI Foundry Discord

Segui questi passaggi per iniziare a utilizzare queste risorse:

  1. Fai il Fork del Repository: Clicca Fork GitHub
  2. Clona il Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. 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

🧭 Panoramica del Curriculum MCP

📚 Struttura Completa del Curriculum

ModuloArgomentoDescrizioneLink
Modulo 1-3: Fondamenti
00Introduzione a MCPPanoramica del Model Context Protocol e della sua importanza nei flussi di lavoro AILeggi di più
01Concetti ChiaveEsplorazione approfondita dei concetti fondamentali di MCPLeggi di più
02Sicurezza in MCPMinacce alla sicurezza e migliori praticheLeggi di più
03Iniziare con MCPConfigurazione dell’ambiente, server/client di base, integrazioneLeggi di più
Modulo 3: Creazione del Primo Server e Client
3.1Primo ServerCrea il tuo primo server MCPGuida
3.2Primo ClientSviluppa un client MCP di baseGuida
3.3Client con LLMIntegra modelli di linguaggio di grandi dimensioniGuida
3.4Integrazione con VS CodeConsuma server MCP in VS CodeGuida
3.5Server stdioCrea server utilizzando il trasporto stdioGuida
3.6Streaming HTTPImplementa lo streaming HTTP in MCPGuida
3.7Toolkit AIUsa il Toolkit AI con MCPGuida
3.8TestingTesta l’implementazione del tuo server MCPGuida
3.9DeploymentDistribuisci server MCP in produzioneGuida
3.10Uso avanzato del serverUsa server avanzati per funzionalità avanzate e architetture migliorateGuida
3.11Autenticazione sempliceUn capitolo che mostra l’autenticazione dall’inizio e RBACGuida
Modulo 4-5: Pratico e Avanzato
04Implementazione PraticaSDK, debug, test, modelli di prompt riutilizzabiliLeggi di più
05Argomenti Avanzati in MCPAI multi-modale, scalabilità, utilizzo aziendaleLeggi di più
5.1Integrazione con AzureIntegrazione MCP con AzureGuida
5.2Multi-modalitàLavorare con più modalitàGuida
5.3Demo OAuth2Implementa l’autenticazione OAuth2Guida
5.4Contesti RadiceComprendi e implementa contesti radiceGuida
5.5RoutingStrategie di routing MCPGuida
5.6CampionamentoTecniche di campionamento in MCPGuida
5.7ScalabilitàScala le implementazioni MCPGuida
5.8SicurezzaConsiderazioni avanzate sulla sicurezzaGuida
5.9Ricerca WebImplementa funzionalità di ricerca webGuida
5.10Streaming in tempo realeCostruisci funzionalità di streaming in tempo realeGuida
5.11Ricerca in tempo realeImplementa la ricerca in tempo realeGuida
5.12Autenticazione Entra IDAutenticazione con Microsoft Entra IDGuida
5.13Integrazione FoundryIntegra con Azure AI FoundryGuida
5.14Ingegneria del ContestoTecniche per un’efficace ingegneria del contestoGuida
5.15Trasporto Personalizzato MCPImplementazioni di trasporto personalizzatoGuida
Modulo 6-10: Community e Migliori Pratiche
06Contributi della CommunityCome contribuire all’ecosistema MCPGuida
07Approfondimenti dall’Adozione InizialeStorie di implementazione nel mondo realeGuida
08Migliori Pratiche per MCPPrestazioni, tolleranza ai guasti, resilienzaGuida
09Studi di Caso MCPEsempi pratici di implementazioneGuida
10Workshop PraticoCostruire un server MCP con AI ToolkitLaboratorio
Modulo 11: Laboratorio Pratico Server MCP
11Integrazione del Database Server MCPPercorso di apprendimento pratico completo di 13 laboratori per l’integrazione con PostgreSQLLaboratori
11.1IntroduzionePanoramica di MCP con integrazione del database e caso d’uso per analisi di vendita al dettaglioLaboratorio 00
11.2Architettura CoreComprendere l’architettura del server MCP, i livelli del database e i modelli di sicurezzaLab 01
11.3Sicurezza e Multi-TenancySicurezza a livello di riga, autenticazione e accesso ai dati multi-tenantLab 02
11.4Configurazione dell’AmbienteConfigurazione dell’ambiente di sviluppo, Docker, risorse AzureLab 03
11.5Progettazione del DatabaseConfigurazione di PostgreSQL, progettazione dello schema retail e dati di esempioLab 04
11.6Implementazione del Server MCPCreazione del server FastMCP con integrazione del databaseLab 05
11.7Sviluppo di StrumentiCreazione di strumenti per query al database e introspezione dello schemaLab 06
11.8Ricerca SemanticaImplementazione di embedding vettoriali con Azure OpenAI e pgvectorLab 07
11.9Test e DebuggingStrategie di test, strumenti di debugging e approcci di validazioneLab 08
11.10Integrazione con VS CodeConfigurazione dell’integrazione MCP con VS Code e utilizzo di AI ChatLab 09
11.11Strategie di DeploymentDeployment con Docker, Azure Container Apps e considerazioni sullo scalingLab 10
11.12MonitoraggioApplication Insights, logging e monitoraggio delle prestazioniLab 11
11.13Best PracticesOttimizzazione delle prestazioni, rafforzamento della sicurezza e consigli per la produzioneLab 12

💻 Progetti di Codice di Esempio

Esempi Base di Calcolatori MCP

LinguaggioDescrizioneLink
C#Esempio di Server MCPVisualizza Codice
JavaCalcolatore MCPVisualizza Codice
JavaScriptDemo MCPVisualizza Codice
PythonServer MCPVisualizza Codice
TypeScriptEsempio MCPVisualizza Codice
RustEsempio MCPVisualizza Codice

Implementazioni Avanzate di MCP

LinguaggioDescrizioneLink
C#Esempio AvanzatoVisualizza Codice
Java con SpringEsempio di App ContainerVisualizza Codice
JavaScriptEsempio AvanzatoVisualizza Codice
PythonImplementazione ComplessaVisualizza Codice
TypeScriptEsempio di ContainerVisualizza 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:

  1. Spiegazioni chiare dei concetti MCP
  2. Esempi di codice live in più linguaggi
  3. Esercizi per costruire applicazioni MCP reali
  4. 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:

™️ 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:

Discord Azure AI Foundry

Se hai feedback sui prodotti o riscontri errori durante la creazione, visita:

Forum degli sviluppatori Azure AI Foundry


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.