Skip to content

Latest commit

 

History

History
273 lines (204 loc) · 21.2 KB

File metadata and controls

273 lines (204 loc) · 21.2 KB

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

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 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 Test 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 modalità multiple 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'ingegneria del contesto efficace 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 | Lezioni 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 |

💻 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 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 Apprendere 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 apprendere 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
  • Analisi 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:

  • 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 diversi linguaggi
  3. Esercizi per costruire applicazioni MCP reali
  4. Risorse extra per studenti avanzati

Eventi

Preparati per due giorni di approfondimenti tecnici, connessioni 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.

È tutto incentrato sull'empowerment degli sviluppatori per utilizzare MCP nel loro flusso di lavoro e 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 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 offrirà ispirazione e spunti pratici.

È dedicato ai costruttori MCP. Approfondiremo strategie di implementazione e migliori pratiche per creare server MCP e integrare MCP nei tuoi 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.

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.

🌟 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 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 Linee Guida sui Marchi e il 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 AI Co-op Translator. Sebbene ci impegniamo per garantire l'accuratezza, si prega di notare che le traduzioni automatizzate 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 esperto umano. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.