Skip to content

Latest commit

 

History

History
264 lines (197 loc) · 20.2 KB

File metadata and controls

264 lines (197 loc) · 20.2 KB

MCP-per-principianti

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. Fork del Repository: Clicca 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)

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 software, questa guida è la tua risorsa completa per padroneggiare i fondamenti e le strategie di implementazione di MCP.

🔗 Risorse Ufficiali MCP

🧭 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 Spiegati Esplorazione approfondita dei concetti chiave 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 Utilizza 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 Utilizza 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
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
Modulo 6-10: Community e Best Practices
06 Contributi della Community Come contribuire all'ecosistema MCP Guida
07 Approfondimenti dall'Adozione Iniziale Storie di implementazione nel mondo reale Guida
08 Best Practices 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

💻 Progetti di Codice di Esempio

Esempi di Calcolatori MCP di Base

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 MCP

Linguaggio Descrizione Link
C# Esempio Avanzato View Code
Java con Spring Esempio di App Container View Code
JavaScript Esempio Avanzato View Code
Python Implementazione Complessa View Code
TypeScript Esempio di Container View Code

🎯 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 & 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
  • Una descrizione 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 completare 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 alla documentazione

🛠️ Come Utilizzare Questo Curriculum in Modo Efficace

Ogni lezione in questa guida include:

  1. Spiegazioni chiare dei concetti MCP
  2. Esempi di codice dal vivo in più linguaggi
  3. Esercizi per costruire applicazioni MCP reali
  4. Risorse extra per studenti avanzati

Eventi

Preparati per 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 e gli strumenti su cui si basano. Puoi guardare i MCP Dev Days registrandoti sulla nostra pagina dell'evento: https://aka.ms/mcpdevdays.

È 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 modellare un ecosistema MCP aperto ed estensibile.
Demo reali con VS Code, Visual Studio, GitHub Copilot e strumenti popolari della community
Flussi di lavoro pratici e orientati al contesto
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.

È dedicato ai costruttori MCP. Approfondiremo strategie di implementazione e migliori pratiche per creare server MCP e integrare MCP nei flussi di lavoro AI.

Argomenti trattati:

  • Creazione di server MCP e loro integrazione nelle esperienze degli agenti
  • Sviluppo guidato dai prompt
  • Migliori pratiche di sicurezza
  • Utilizzo di componenti 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.

🌟 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 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 maggiori 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-10): Il contenuto principale organizzato in dieci moduli sequenziali
  • 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

Questo progetto potrebbe contenere marchi o loghi relativi a progetti, prodotti o servizi. L'uso autorizzato dei marchi o loghi Microsoft è soggetto e deve seguire le Linee Guida sui Marchi e Brand di Microsoft. L'uso dei marchi o loghi Microsoft in versioni modificate di questo progetto non deve causare confusione o implicare sponsorizzazione da parte di Microsoft. Qualsiasi utilizzo 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. Sebbene ci impegniamo per garantire l'accuratezza, si prega di notare che le traduzioni automatiche potrebbero contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si consiglia una traduzione professionale eseguita da un traduttore umano. Non siamo responsabili per eventuali fraintendimenti o interpretazioni errate derivanti dall'uso di questa traduzione.