wehub/microsoft--mcp-for-beginners

Fork 0

Files

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

37 KiB

Raw Blame History

Segui questi passaggi per iniziare a utilizzare queste risorse:

Fork del Repository: Clicca
Clona il Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
Unisciti a

🌐 Supporto Multilingue

Supportato tramite GitHub Action (Automatizzato e Sempre Aggiornato)

Preferisci clonare localmente?

Questo repository include traduzioni in oltre 50 lingue, il che aumenta significativamente la dimensione del download. Per clonare senza le traduzioni, usa sparse checkout:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Questo ti fornisce tutto il necessario per completare il corso con un download molto più veloce.

🚀 Curriculum del Model Context Protocol (MCP) per Principianti

Impara MCP con esempi pratici in C#, Java, JavaScript, Rust, Python e TypeScript

🧠 Panoramica del Curriculum Model Context Protocol

Benvenuto nel tuo viaggio all’interno del Model Context Protocol! Se ti sei mai chiesto come le applicazioni di IA comunicano con strumenti e servizi diversi, stai per scoprire la soluzione elegante che sta trasformando il modo in cui gli sviluppatori costruiscono sistemi intelligenti.

Pensa a MCP come a un traduttore universale per le applicazioni di IA – proprio come le porte USB ti permettono di collegare qualsiasi dispositivo al tuo computer, MCP consente ai modelli di IA di collegarsi a qualsiasi strumento o servizio in modo standardizzato. Che tu stia costruendo il tuo primo chatbot o lavorando su flussi di lavoro AI complessi, comprendere MCP ti darà il potere di creare applicazioni più capaci e flessibili.

Questo curriculum è progettato con pazienza e cura per il tuo percorso di apprendimento. Inizieremo con concetti semplici che già conosci e costruiremo gradualmente la tua competenza attraverso esercizi pratici nel tuo linguaggio di programmazione preferito. Ogni passo include spiegazioni chiare, esempi pratici e tanto incoraggiamento lungo il percorso.

Quando avrai completato questo viaggio, avrai la fiducia per costruire i tuoi server MCP, integrarli con piattaforme AI popolari e capire come questa tecnologia stia rimodellando il futuro dello sviluppo dell’IA. Iniziamo insieme questa entusiasmante avventura!

Documentazione e Specifiche Ufficiali

Questo curriculum è allineato con MCP Specification 2025-11-25 (l’ultima release stabile). La specifica MCP utilizza la versione basata sulla data (formato YYYY-MM-DD) per garantire un chiaro tracciamento delle versioni del protocollo.

Queste risorse diventano più preziose man mano che cresce la tua comprensione, ma non sentirti sotto pressione di leggerle tutte subito. Inizia dalle aree che ti interessano di più!

📘 Documentazione MCP – Questa è la tua risorsa principale per tutorial passo dopo passo e guide per l’utente. La documentazione è scritta pensando ai principianti, fornendo esempi chiari da seguire al tuo ritmo.
📜 Specifiche MCP – Considerala come il tuo manuale di riferimento completo. Mentre procedi nel curriculum, tornerai qui per consultare dettagli specifici e esplorare funzionalità avanzate.
📜 Versionamento Specifiche MCP – Qui trovi informazioni sulla storia delle versioni del protocollo e su come MCP utilizza il versionamento basato sulla data (formato YYYY-MM-DD).
🧑‍💻 Repository GitHub MCP – Qui troverai SDK, strumenti ed esempi di codice in diversi linguaggi di programmazione. È come una miniera di esempi pratici e componenti pronti all’uso.
🌐 Community MCP – Unisciti a colleghi studenti e sviluppatori esperti nelle discussioni su MCP. È una community di supporto dove le domande sono benvenute e la conoscenza viene condivisa liberamente.

Obiettivi di Apprendimento

Al termine di questo curriculum ti sentirai sicuro ed entusiasta delle tue nuove competenze. Ecco cosa otterrai:

• Comprendere le basi di MCP: Capirai cos’è il Model Context Protocol e perché sta rivoluzionando il modo in cui le applicazioni di IA lavorano insieme, usando analogie ed esempi semplici da comprendere.

• Costruire il tuo primo server MCP: Creerai un server MCP funzionante nel tuo linguaggio di programmazione preferito, iniziando con esempi semplici e aumentando passo dopo passo le tue abilità.

• Collegare modelli AI a strumenti reali: Imparerai a colmare il divario tra i modelli di IA e i servizi reali, dando alle tue applicazioni nuove capacità potenti.

• Implementare le migliori pratiche di sicurezza: Capirai come mantenere sicure le tue implementazioni MCP, proteggendo sia le tue applicazioni che i tuoi utenti.

• Distribuire con sicurezza: Saprai come portare i tuoi progetti MCP dallo sviluppo alla produzione, con strategie pratiche di deployment che funzionano nel mondo reale.

• Entrare nella community MCP: Diventerai parte di una community in crescita di sviluppatori che stanno plasmando il futuro dello sviluppo di applicazioni AI.

Fondamenti Essenziali

Prima di immergerci nei dettagli di MCP, assicuriamoci che tu abbia confidenza con alcuni concetti di base. Non preoccuparti se non sei un esperto in queste aree – ti spiegheremo tutto ciò che ti serve strada facendo!

Comprendere i Protocolli (La Fondamenta)

Pensa a un protocollo come alle regole di una conversazione. Quando telefoni a un amico, entrambi sapete di dire “ciao” appena rispondete, di parlare a turno e di dire “arrivederci” alla fine. Anche i programmi per computer hanno bisogno di regole simili per comunicare efficacemente.

MCP è un protocollo – un insieme di regole concordate che aiutano i modelli IA e le applicazioni ad avere “conversazioni” produttive con strumenti e servizi. Proprio come le regole rendono più fluida la comunicazione umana, avere MCP rende la comunicazione tra applicazioni IA molto più affidabile e potente.

Relazioni Client-Server (Come i Programmi Collaborano)

Usi già ogni giorno le relazioni client-server! Quando usi un browser (client) per visitare un sito web, ti connetti a un server web che ti manda il contenuto della pagina. Il browser sa come richiedere informazioni, il server sa come rispondere.

In MCP abbiamo una relazione simile: i modelli IA agiscono da client che richiedono informazioni o azioni, mentre i server MCP forniscono queste capacità. È come avere un assistente (il server) che l’IA può chiedere di eseguire compiti specifici.

Perché la Standardizzazione è Importante (Far Funzionare le Cose Insieme)

Immagina se ogni fabbricante di automobili usasse una forma diversa per il tubo di benzina – avresti bisogno di un adattatore diverso per ogni auto! La standardizzazione significa accordarsi su approcci comuni per far funzionare tutto insieme senza problemi.

MCP fornisce questa standardizzazione per le applicazioni IA. Invece di dover scrivere codice personalizzato per ogni modello IA con ogni strumento, MCP crea un modo universale per comunicare. Questo permette agli sviluppatori di costruire strumenti una sola volta e farli funzionare con molti sistemi IA diversi.

🧭 Panoramica del Tuo Percorso di Apprendimento

Il tuo viaggio MCP è strutturato con attenzione per costruire fiducia e competenze in modo progressivo. Ogni fase introduce nuovi concetti rafforzando quanto già imparato.

🌱 Fase Fondamenta: Comprendere le Basi (Moduli 0-2)

Qui inizia la tua avventura! Ti introdurremo ai concetti MCP usando analogie familiari ed esempi semplici. Capirai cos’è MCP, perché esiste e come si inserisce nel mondo più grande dello sviluppo AI.

• Modulo 0 - Introduzione a MCP: Inizieremo esplorando cos’è MCP e perché è così importante per le applicazioni AI moderne. Vedrai esempi reali di MCP in azione e capirai come risolve problemi comuni per gli sviluppatori.

• Modulo 1 - Concetti Chiave Spiegati: Qui imparerai i mattoni essenziali di MCP. Useremo molte analogie ed esempi visivi per far sentire questi concetti naturali e comprensibili.

• Modulo 2 - Sicurezza in MCP: La sicurezza può sembrare intimidatoria, ma ti mostreremo come MCP include meccanismi integrati per la protezione e ti insegneremo le migliori pratiche per proteggere le tue applicazioni fin dall’inizio.

🔨 Fase di Costruzione: Creare le Tue Prime Implementazioni (Modulo 3)

Ora inizia il vero divertimento! Metterai le mani in pasta costruendo veri server e client MCP. Non preoccuparti - inizieremo in modo semplice e ti guideremo passo dopo passo.

Questo modulo include diverse guide pratiche che ti permettono di esercitarti nel linguaggio di programmazione che preferisci. Creerai il tuo primo server, costruirai un client per connetterti a esso e persino integrarti con strumenti di sviluppo popolari come VS Code.

Ogni guida include esempi di codice completi, suggerimenti per la risoluzione dei problemi e spiegazioni sul perché facciamo determinate scelte progettuali. Alla fine di questa fase avrai implementazioni MCP funzionanti di cui potrai essere orgoglioso!

🚀 Fase di Crescita: Concetti Avanzati e Applicazioni nel Mondo Reale (Moduli 4-5)

Con le basi padroneggiate, sei pronto a esplorare funzionalità MCP più sofisticate. Tratteremo strategie pratiche di implementazione, tecniche di debug e argomenti avanzati come l'integrazione di AI multimodale.

Imparerai anche come scalare le tue implementazioni MCP per l'uso in produzione e integrarti con piattaforme cloud come Azure. Questi moduli ti preparano a costruire soluzioni MCP in grado di affrontare le esigenze del mondo reale.

🌟 Fase di Maestria: Comunità e Specializzazione (Moduli 6-11)

La fase finale si concentra sul diventare parte della comunità MCP e specializzarsi nelle aree che ti interessano di più. Imparerai come contribuire a progetti MCP open-source, implementare schemi avanzati di autenticazione e costruire soluzioni integrate con database complete.

Il Modulo 11 merita una menzione speciale - è un percorso completo di apprendimento pratico con 13 laboratori che ti insegna a costruire server MCP pronti per la produzione con integrazione PostgreSQL. È come un progetto finale che unisce tutto ciò che hai imparato!

📚 Struttura Completa del Curriculum

Modulo	Argomento	Descrizione	Link
Moduli 0-3: Fondamenti
00	Introduzione a MCP	Panoramica sul Model Context Protocol e la sua importanza nelle pipeline AI	Leggi di più
01	Concetti Chiave Spiegati	Esplorazione approfondita dei concetti core MCP	Leggi di più
02	Sicurezza in MCP	Minacce alla sicurezza e best practice	Leggi di più
03	Iniziare con MCP	Configurazione ambiente, server/client di base, integrazione	Leggi di più
Modulo 3: Costruire il tuo Primo Server & 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 VS Code	Usa 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	Microsoft Foundry Toolkit	Usa Microsoft Foundry Toolkit con MCP	Guida
3.8	Testing	Testa la tua implementazione del server MCP	Guida
3.9	Deployment	Distribuisci server MCP in produzione	Guida
3.10	Uso avanzato server	Usa server avanzati per funzionalità avanzate e architettura migliorata	Guida
3.11	Autenticazione semplice	Un capitolo che mostra l'autenticazione dall'inizio e RBAC	Guida
3.12	Host MCP	Configura Claude Desktop, Cursor, Cline e altri host MCP	Guida
3.13	MCP Inspector	Debug e test dei server MCP con lo strumento Inspector	Guida
3.14	Campionamento	Usa il campionamento per collaborare con il client	Guida
3.15	App MCP	Crea App MCP	Guida
Moduli 4-5: Pratico & Avanzato
04	Implementazione Pratica	SDK, debug, testing, modelli di prompt riutilizzabili	Leggi di più
4.1	Paginazione	Gestisci grandi insiemi di risultati con paginazione a cursore	Guida
05	Argomenti Avanzati in MCP	AI multimodale, scaling, uso enterprise	Leggi di più
5.1	Integrazione Azure	Integrazione MCP con Azure	Guida
5.2	Multimodalità	Lavorare con modalità multiple	Guida
5.3	Demo OAuth2	Implementa autenticazione OAuth2	Guida
5.4	Root Contexts	Comprendere e implementare 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 capacità di ricerca web	Guida
5.10	Streaming Realtime	Costruisci funzionalità di streaming in tempo reale	Guida
5.11	Ricerca Realtime	Implementa ricerca in tempo reale	Guida
5.12	Autenticazione Entra ID	Autenticazione con Microsoft Entra ID	Guida
5.13	Integrazione Foundry	Integra con Microsoft 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
5.16	Funzionalità del Protocollo	Notifiche di progresso, cancellazione, template di risorse	Guida
5.17	Ragionamento Multi-Agent Avversariale	Due agenti discutono opposte posizioni usando strumenti MCP condivisi, valutati da un agente giudice	Guida
Moduli 6-10: Comunità & Best Practices
06	Contributi Comunitari	Come contribuire all'ecosistema MCP	Guida
07	Esperienze dagli Early Adopters	Storie di implementazione nel mondo reale	Guida
08	Best Practices per MCP	Performance, tolleranza ai guasti, resilienza	Guida
09	Case Studies MCP	Esempi pratici di implementazione	Guida
10	Workshop Pratico	Costruire un Server MCP con Microsoft Foundry Toolkit	Lab
Modulo 11: Laboratori Pratici MCP Server
11	Integrazione Database MCP Server	Percorso completo di apprendimento con 13 laboratori per integrazione con PostgreSQL	Lab
11.1	Introduzione	Panoramica su MCP con integrazione database e caso d'uso retail analytics	Lab 00
11.2	Architettura Core	Comprensione dell'architettura server MCP, livelli database e pattern di sicurezza	Lab 01
11.3	Sicurezza & Multi-Tenancy	Row Level Security, autenticazione e accesso dati multi-tenant	Lab 02
11.4	Configurazione Ambiente	Configurazione ambiente di sviluppo, Docker, risorse Azure	Lab 03
11.5	Progettazione Database	Setup PostgreSQL, design schema retail e dati di esempio	Lab 04
11.6	Implementazione Server MCP	Costruzione del server FastMCP con integrazione database	Lab 05
11.7	Sviluppo Strumenti	Creazione di strumenti per query database e introspezione schema	Lab 06
11.8	Ricerca Semantica	Implementazione di vettori embedding con Azure OpenAI e pgvector	Lab 07
11.9	Testing & Debugging	Strategie di test, strumenti di debug e approcci di validazione	Lab 08
11.10	Integrazione VS Code	Configurazione di VS Code per integrazione MCP e uso 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 performance	Lab 11
11.13	Best Practices	Ottimizzazione delle performance, rafforzamento sicurezza e consigli per produzione	Lab 12
Modulo 12: Tooling MCP
12.1	Tooling	Uso MCP in Copilot App	Guida

💻 Progetti di Codice di Esempio

Una delle parti più entusiasmanti dell'apprendimento di MCP è vedere le tue abilità di programmazione svilupparsi progressivamente. Abbiamo progettato i nostri esempi di codice per iniziare semplici e diventare più sofisticati man mano che approfondisci la comprensione. Ecco come introduciamo i concetti - con codice facile da capire ma che dimostra reali principi MCP, comprenderai non solo cosa fa questo codice, ma perché è strutturato così e come si inserisce in applicazioni MCP più ampie.

Esempi Base di Calcolatore MCP

Linguaggio	Descrizione	Link
C#	Esempio 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 MCP Avanzate

Linguaggio	Descrizione	Link
C#	Esempio Avanzato	Visualizza Codice
Java con Spring	Esempio Container App	Visualizza Codice
JavaScript	Esempio Avanzato	Visualizza Codice
Python	Implementazione Complessa	Visualizza Codice
TypeScript	Esempio Container	Visualizza Codice

🎯 Prerequisiti per l'Apprendimento di MCP

Per ottenere il massimo da questo curriculum, dovresti avere:

Conoscenze di base di 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 & 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 questo repository. Questa mappa visiva del curriculum mostra come tutti gli argomenti sono connessi e fornisce indicazioni su come usare efficacemente i progetti campione. È particolarmente utile se sei un apprendente visivo che ama vedere il quadro generale.

La guida include:

Una mappa visiva del curriculum che mostra tutti gli argomenti trattati
Analisi dettagliata di ogni sezione del repository
Indicazioni su come usare i progetti campione
Percorsi di apprendimento consigliati per diversi livelli di abilità
Risorse aggiuntive per integrare il tuo percorso di apprendimento

Registro delle Modifiche

Manteniamo un dettagliato Registro delle Modifiche che tiene traccia di tutti gli aggiornamenti significativi ai materiali del curriculum, così puoi rimanere aggiornato con le ultime migliorie e aggiunte.

Nuovi contenuti aggiunti
Cambiamenti strutturali
Miglioramenti delle funzionalità
Aggiornamenti della documentazione

🛠️ Come Usare Efficacemente Questo Curriculum

Ogni lezione in questa guida include:

Spiegazioni chiare dei concetti MCP
Esempi di codice live in più linguaggi
Esercizi per costruire vere applicazioni MCP
Risorse extra per apprendenti avanzati

Impariamo MCP con C# - Serie Tutorial

Impariamo il Model Context Protocol (MCP), un framework all'avanguardia progettato per standardizzare le interazioni tra modelli AI ed 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

🎓 Il Tuo Viaggio MCP Inizia

Congratulazioni! Hai appena fatto il primo passo in un viaggio emozionante che espanderà le tue capacità di programmazione e ti collegherà all'avanguardia dello sviluppo AI.

Quello che Hai Già Realizzato

Leggendo questa introduzione, hai già iniziato a costruire la tua base di conoscenza MCP. Comprendi cos'è MCP, perché è importante e come questo curriculum supporterà il tuo percorso di apprendimento. È un traguardo significativo e l'inizio della tua competenza in questa importante tecnologia.

L'Avventura che Ti Aspetta

Mentre procedi attraverso i moduli, ricorda che ogni esperto è stato una volta un principiante. I concetti che ora sembrano complessi diventeranno naturali man mano che li pratichi e applichi. Ogni piccolo passo costruisce potenti capacità che ti serviranno per tutta la tua carriera di sviluppo.

La Tua Rete di Supporto

Ti unisci a una comunità di apprendenti ed esperti appassionati di MCP e desiderosi di aiutare gli altri a riuscire. Che tu sia bloccato su una sfida di coding o entusiasta di condividere una scoperta, la comunità è qui per supportarti nel tuo percorso.

Se resti bloccato o hai domande sulla costruzione di app AI. Unisciti a studenti ed esperti sviluppatori nelle discussioni su MCP. È una comunità di supporto dove le domande sono benvenute e la conoscenza è condivisa liberamente.

Se hai feedback sul prodotto o riscontri errori durante lo sviluppo visita:

Pronto per Iniziare?

La tua avventura MCP inizia ora! Inizia con il Modulo 0 per immergerti nelle tue prime esperienze pratiche con MCP, oppure esplora i progetti campione per vedere cosa costruirai. Ricorda - ogni esperto ha iniziato esattamente da dove sei ora e con pazienza e pratica, sarai stupito di cosa riuscirai a realizzare.

Benvenuto nel mondo dello sviluppo Model Context Protocol. Costruiamo qualcosa di straordinario insieme!

🤝 Contribuire alla Community di Apprendimento

Questo curriculum cresce più forte con i contributi di apprendenti come te! Che tu stia correggendo un errore di battitura, suggerendo una spiegazione più chiara o aggiungendo un nuovo esempio, i tuoi contributi aiutano altri principianti a riuscire.

Grazie al Microsoft Valued Professional Shivam Goyal per aver contribuito con esempi di codice.

Il processo di contributo è progettato per essere accogliente e di supporto. La maggior parte dei contributi richiede un Contributor License Agreement (CLA), ma gli strumenti automatici ti guideranno nel processo in modo semplice.

📜 Apprendimento Open Source

Questo intero curriculum è disponibile sotto la licenza MIT LICENSE, il che significa che puoi usarlo, modificarlo e condividerlo liberamente. Questo supporta la nostra missione di rendere le conoscenze MCP accessibili a sviluppatori ovunque.

🤝 Linee Guida per i Contributi

Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede l'accettazione di un Contributor License Agreement (CLA) che dichiara che hai il diritto, e effettivamente concedi, i diritti di usare il tuo contributo. Per dettagli visita https://cla.opensource.microsoft.com.

Quando invii una pull request, un bot CLA déterminerà automaticamente se devi fornire un CLA e decorerà la PR di conseguenza (ad esempio, controllo stato, commento). Segui semplicemente le istruzioni fornite dal bot. Dovrai farlo solo una volta su tutti i repo che usano 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.

Pronto a iniziare il tuo viaggio con MCP? Inizia con Modulo 00 - Introduzione a MCP e compi i tuoi primi passi nel mondo dello sviluppo Model Context Protocol!

🎒 Altri Corsi

Il nostro team produce altri corsi! Dai un’occhiata a:

LangChain

Azure / Edge / MCP / Agents

Serie Generative AI

Apprendimento Base

Serie Copilot

Disclaimer: Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Sebbene ci impegniamo per garantire la precisione, si prega di notare che le traduzioni automatizzate 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 essere umano. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.

37 KiB Raw Blame History Unescape Escape