Skip to content

Latest commit

 

History

History
197 lines (165 loc) · 7.84 KB

study_guide.md

File metadata and controls

197 lines (165 loc) · 7.84 KB

Protocollo del Contesto Modello (MCP) per Principianti - Guida di Studio

Questa guida di studio fornisce una panoramica della struttura e dei contenuti del repository per il curriculum "Protocollo del Contesto Modello (MCP) per Principianti". Usa questa guida per navigare nel repository in modo efficiente e sfruttare al massimo le risorse disponibili.

Panoramica del Repository

Il Protocollo del Contesto Modello (MCP) è un framework standardizzato per le interazioni tra modelli AI e applicazioni client. Questo repository offre un curriculum completo con esempi pratici di codice in C#, Java, JavaScript, Python e TypeScript, pensato per sviluppatori AI, architetti di sistema e ingegneri del software.

Mappa Visiva del Curriculum

mindmap
  root((MCP for Beginners))
    00. Introduction
      ::icon(fa fa-book)
      (Protocol Overview)
      (Standardization)
      (Use Cases)
    01. Core Concepts
      ::icon(fa fa-puzzle-piece)
      (Client-Server Architecture)
      (Protocol Components)
      (Messaging Patterns)
    02. Security
      ::icon(fa fa-shield)
      (Threat Models)
      (Best Practices)
      (Auth Strategies)
    03. Getting Started
      ::icon(fa fa-rocket)
      (First Server)
      (First Client)
      (LLM Client)
      (VS Code Integration)
      (SSE Server)
      (AI Toolkit)
      (Testing)
      (Deployment)
    04. Practical Implementation
      ::icon(fa fa-code)
      (SDKs)
      (Testing/Debugging)
      (Prompt Templates)
      (Sample Projects)
    05. Advanced Topics
      ::icon(fa fa-graduation-cap)
      (Multi-modal AI)
      (Scaling)
      (Enterprise Integration)
      (Azure Integration)
      (OAuth2)
      (Root Contexts)
    06. Community
      ::icon(fa fa-users)
      (Code Contributions)
      (Documentation)
      (Feedback)
    07. Early Adoption
      ::icon(fa fa-lightbulb)
      (Real-world Examples)
      (Deployment Stories)
      (Future Roadmap)
    08. Best Practices
      ::icon(fa fa-check)
      (Performance)
      (Fault Tolerance)
      (Resilience)
    09. Case Studies
      ::icon(fa fa-file-text)
      (Solution Architectures)
      (Deployment Blueprints)
      (Project Walkthroughs)
    10. Hands-on Workshop
      ::icon(fa fa-laptop)
      (AI Toolkit Integration)
      (Custom Server Development)
      (Production Deployment)
Loading

Struttura del Repository

Il repository è organizzato in dieci sezioni principali, ognuna focalizzata su diversi aspetti del MCP:

  1. Introduzione (00-Introduction/)

    • Panoramica del Protocollo del Contesto Modello
    • Perché la standardizzazione è importante nelle pipeline AI
    • Casi d’uso pratici e vantaggi

  2. Concetti Fondamentali (01-CoreConcepts/)

    • Architettura client-server
    • Componenti chiave del protocollo
    • Pattern di messaggistica in MCP

  3. Sicurezza (02-Security/)

    • Minacce alla sicurezza nei sistemi basati su MCP
    • Best practice per implementazioni sicure
    • Strategie di autenticazione e autorizzazione

  4. Primi Passi (03-GettingStarted/)

    • Configurazione dell’ambiente
    • Creazione di server e client MCP di base
    • Integrazione con applicazioni esistenti
    • Sottosezioni per primo server, primo client, client LLM, integrazione con VS Code, server SSE, AI Toolkit, testing e deployment

  5. Implementazione Pratica (04-PracticalImplementation/)

    • Uso degli SDK in diversi linguaggi di programmazione
    • Tecniche di debugging, testing e validazione
    • Creazione di template di prompt riutilizzabili e workflow
    • Progetti di esempio con implementazioni pratiche

  6. Argomenti Avanzati (05-AdvancedTopics/)

    • Workflow AI multi-modale e estendibilità
    • Strategie di scaling sicuro
    • MCP negli ecosistemi enterprise
    • Temi specializzati tra cui integrazione Azure, multi-modality, OAuth2, root contexts, routing, sampling, scaling, sicurezza, integrazione web search e streaming.

  7. Contributi della Comunità (06-CommunityContributions/)

    • Come contribuire con codice e documentazione
    • Collaborazione tramite GitHub
    • Miglioramenti guidati dalla comunità e feedback

  8. Lezioni dall’Adozione Precoce (07-LessonsfromEarlyAdoption/)

    • Implementazioni reali e casi di successo
    • Costruzione e deployment di soluzioni basate su MCP
    • Tendenze e roadmap futura

  9. Best Practices (08-BestPractices/)

    • Ottimizzazione delle prestazioni
    • Progettazione di sistemi MCP fault-tolerant
    • Strategie di testing e resilienza

  10. Case Study (09-CaseStudy/)

    • Analisi approfondite di architetture di soluzioni MCP
    • Blueprint di deployment e suggerimenti per l’integrazione
    • Diagrammi annotati e walkthrough di progetti

  11. Workshop Pratico (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)

    • Workshop pratico completo che unisce MCP e AI Toolkit di Microsoft per VS Code
    • Costruzione di applicazioni intelligenti che collegano modelli AI con strumenti reali
    • Moduli pratici che coprono fondamentali, sviluppo di server personalizzati e strategie di deployment in produzione

Progetti di Esempio

Il repository include diversi progetti di esempio che mostrano l’implementazione di MCP in vari linguaggi di programmazione:

Esempi Base di Calcolatore MCP

  • Esempio di Server MCP in C#
  • Calcolatore MCP in Java
  • Demo MCP in JavaScript
  • Server MCP in Python
  • Esempio MCP in TypeScript

Progetti Avanzati di Calcolatore MCP

  • Esempio Avanzato in C#
  • Applicazione Container Java
  • Esempio Avanzato in JavaScript
  • Implementazione Complessa in Python
  • Esempio Container in TypeScript

Risorse Aggiuntive

Il repository include risorse di supporto:

Come Usare Questo Repository

  1. Apprendimento Sequenziale: Segui i capitoli in ordine (da 00 a 10) per un’esperienza di apprendimento strutturata.
  2. Focus su Linguaggi Specifici: Se ti interessa un linguaggio di programmazione in particolare, esplora le cartelle dei sample per le implementazioni nella tua lingua preferita.
  3. Implementazione Pratica: Inizia dalla sezione "Getting Started" per configurare l’ambiente e creare il tuo primo server e client MCP.
  4. Esplorazione Avanzata: Una volta acquisiti i concetti base, approfondisci gli argomenti avanzati per ampliare le tue conoscenze.
  5. Coinvolgimento nella Comunità: Unisciti al Azure AI Foundry Discord per connetterti con esperti e altri sviluppatori.

Contributi

Questo repository accoglie contributi dalla comunità. Consulta la sezione Community Contributions per indicazioni su come partecipare.

Questa guida di studio è stata creata l’11 giugno 2025 e fornisce una panoramica del repository aggiornata a quella data. I contenuti del repository potrebbero essere stati aggiornati successivamente.

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per l'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 la traduzione professionale umana. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall'uso di questa traduzione.