Skip to content

Latest commit

 

History

History
263 lines (194 loc) · 19.5 KB

File metadata and controls

263 lines (194 loc) · 19.5 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Segui questi passaggi per iniziare a utilizzare queste risorse:

  1. Forka il Repository: Clicca su GitHub forks
  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)

Francese | Spagnolo | Tedesco | Russo | Arabo | Persiano (Farsi) | Urdu | Cinese (Semplificato) | Cinese (Tradizionale, Macao) | Cinese (Tradizionale, Hong Kong) | Cinese (Tradizionale, Taiwan) | Giapponese | Coreano | Hindi | Bengalese | Marathi | Nepalese | Punjabi (Gurmukhi) | Portoghese (Portogallo) | Portoghese (Brasile) | Italiano | Polacco | Turco | Greco | Thailandese | Svedese | Danese | Norvegese | Finlandese | Olandese | Ebraico | Vietnamita | Indonesiano | Malese | Tagalog (Filippino) | Swahili | Ungherese | Ceco | Slovacco | Rumeno | Bulgaro | Serbo (Cirillico) | Croato | Sloveno | Ucraino | Birmano (Myanmar)

🚀 Curriculum Model Context Protocol (MCP) per Principianti

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

🧠 Panoramica del Curriculum Model Context Protocol

Il Model Context Protocol (MCP) è un framework all’avanguardia progettato per standardizzare le interazioni tra modelli AI 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 sistema o un ingegnere del software, questa guida è la tua risorsa completa per padroneggiare i fondamenti e le strategie di implementazione di MCP.

🔗 Risorse Ufficiali MCP

Unisciti a noi per MCP Dev Days 29-30 luglio 2025

Preparati a due giorni di approfondimenti tecnici, connessioni con la community e apprendimento pratico durante 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.

➡️ Iscriviti a MCP Dev Days

Potrai seguire MCP Dev Days registrandoti sulla nostra pagina evento: https://aka.ms/mcpdevdays. Da lì potrai accedere a una diretta su YouTube o Twitch. Tutti i contenuti saranno registrati e disponibili successivamente sul canale YouTube di Microsoft Developer. Il codice sorgente delle demo sarà disponibile anche su GitHub.

Dettagli dell’evento

  • Date: 29 luglio (Giorno 1) e 30 luglio (Giorno 2)
  • Orario: 9:00 AM PST ogni giorno
  • Dove: Online – partecipa da qualsiasi luogo!

Giorno 1: Produttività MCP, DevTools e Community

È dedicato a dare potere agli sviluppatori per usare MCP nel loro flusso di lavoro e a celebrare l’incredibile community MCP. Saremo affiancati da membri della community e partner come Arcade, Block, Okta e Neon per vedere come collaborano con Microsoft per creare un ecosistema MCP aperto ed estensibile. Demo reali su VS Code, Visual Studio, GitHub Copilot e strumenti popolari della community
Flussi di lavoro pratici e contestualizzati
Sessioni e approfondimenti guidati dalla community
Che tu stia iniziando con MCP o stia già costruendo con esso, il Giorno 1 ti offrirà ispirazione e spunti concreti.

Giorno 2: Costruisci Server MCP con Fiducia

È pensato per i costruttori MCP. Approfondiremo strategie di implementazione e best practice per creare server MCP e integrare MCP nei tuoi flussi di lavoro AI.

Argomenti trattati:

  • Costruzione di server MCP e integrazione nelle esperienze agenti
  • Sviluppo guidato da prompt
  • Best practice di sicurezza
  • Uso di componenti come Functions, ACA e API Management
  • Allineamento del registro e strumenti (1P + 3P)

Se sei uno sviluppatore, creatore di strumenti o stratega di prodotti AI, questa giornata è ricca di approfondimenti per costruire soluzioni MCP scalabili, sicure e pronte per il futuro.

🧭 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 nelle pipeline AI Leggi di più
01 Concetti Chiave Spiegati Esplorazione approfondita dei concetti fondamentali di MCP Leggi di più
02 Sicurezza in MCP Minacce alla sicurezza e best practice Leggi di più
03 Iniziare con MCP Configurazione dell’ambiente, server/client base, integrazione Leggi di più
Modulo 3: Costruisci 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 Consuma server MCP in VS Code Guida
3.5 Server SSE Crea server usando Server-Sent Events Guida
3.6 Streaming HTTP Implementa lo streaming HTTP in MCP Guida
3.7 AI Toolkit Usa AI Toolkit con MCP Guida
3.8 Testing Testa la tua implementazione del server MCP Guida
3.9 Deployment Distribuisci i server MCP in produzione Guida
Modulo 4-5: Pratico & Avanzato
04 Implementazione Pratica SDK, debugging, testing, template di prompt riutilizzabili Leggi di più
05 Argomenti Avanzati in MCP AI multimodale, scalabilità, uso enterprise Leggi di più
5.1 Integrazione Azure Integrazione MCP con Azure Guida
5.2 Multimodalità Lavorare con più modalità Guida
5.3 Demo OAuth2 Implementa l’autenticazione OAuth2 Guida
5.4 Root Contexts Comprendere e implementare i contesti radice Guida
5.5 Routing Strategie di routing MCP Guida
5.6 Sampling 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 Integrazione con Azure AI Foundry Guida
5.14 Ingegneria del Contesto Tecniche per un’efficace ingegneria del contesto Guida
Modulo 6-10: Comunità e Best Practice
06 Contributi della Comunità Come contribuire all’ecosistema MCP Guida
07 Esperienze dall’Adozione Precoce Storie di implementazioni reali Guida
08 Best Practice per MCP Performance, tolleranza ai guasti, resilienza Guida
09 Casi di Studio MCP Esempi pratici di implementazione Guida
10 Workshop Pratico Costruire un MCP Server con AI Toolkit Lab

💻 Progetti di Codice di Esempio

Esempi Base di Calcolatore MCP

Linguaggio Descrizione Link
C# Esempio di MCP Server Visualizza Codice
Java Calcolatore MCP Visualizza Codice
JavaScript Demo MCP Visualizza Codice
Python MCP Server Visualizza Codice
TypeScript Esempio MCP Visualizza Codice

Implementazioni Avanzate MCP

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

🎯 Prerequisiti per Imparare MCP

Per ottenere il massimo da questo percorso formativo, 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) Conoscenze di base in AI/ML

  • Partecipazione alle discussioni della nostra comunità per supporto

📚 Guida allo Studio e Risorse

Questo repository include diverse risorse per aiutarti a navigare e apprendere efficacemente:

Guida allo Studio

È disponibile una Guida allo Studio completa per aiutarti a orientarti nel repository. La guida include:

  • Una mappa visiva del curriculum con tutti gli argomenti trattati
  • Suddivisione dettagliata 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 arricchire il tuo percorso di apprendimento

Changelog

Manteniamo un Changelog dettagliato che traccia tutti gli aggiornamenti significativi ai materiali del curriculum, inclusi:

  • Nuovi contenuti aggiunti
  • Modifiche strutturali
  • Miglioramenti delle funzionalità
  • Aggiornamenti della documentazione

🛠️ Come Usare 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 chi vuole approfondire

🌟 Ringraziamenti alla Comunità

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

📜 Informazioni sulla Licenza

Questo contenuto è concesso in licenza sotto la MIT License. Per termini e condizioni, consulta il LICENSE.

🤝 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 concedi effettivamente a noi
i diritti di 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 di stato, commento). Segui semplicemente le istruzioni
fornite dal bot. Dovrai farlo solo una volta per tutti i repository che usano il nostro CLA.

Questo progetto ha adottato il Microsoft Open Source Code of Conduct.
Per maggiori informazioni consulta le FAQ sul Codice di Condotta o
contatta opencode@microsoft.com per domande o commenti aggiuntivi.

📂 Struttura del Repository

Il repository è organizzato come segue:

  • Core Curriculum (00-10): Contenuti principali organizzati in dieci moduli sequenziali
  • images/: Diagrammi e illustrazioni usati nel curriculum
  • translations/: Supporto multilingue con traduzioni automatiche
  • translated_images/: Versioni localizzate di diagrammi e illustrazioni
  • study_guide.md: Guida completa per orientarsi 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 a:

™️ Avviso sui Marchi

Questo progetto può contenere marchi o loghi di progetti, prodotti o servizi. L’uso autorizzato dei marchi o loghi Microsoft
è soggetto e deve rispettare le
Linee Guida sui Marchi e Brand di Microsoft.
L’uso di marchi o loghi Microsoft in versioni modificate di questo progetto non deve creare confusione né implicare sponsorizzazione da parte di Microsoft.
Qualsiasi uso di marchi o loghi di terze parti è soggetto alle politiche di tali terze parti.

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Pur impegnandoci per garantire 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.