Questa guida allo studio offre una panoramica della struttura e dei contenuti del repository per il curriculum "Protocollo di Contesto Modello (MCP) per Principianti". Utilizza questa guida per navigare nel repository in modo efficiente e sfruttare al meglio le risorse disponibili.
Il Protocollo di Contesto Modello (MCP) è un framework standardizzato per le interazioni tra modelli di intelligenza artificiale e applicazioni client. Creato inizialmente da Anthropic, MCP è ora mantenuto dalla comunità MCP attraverso l'organizzazione ufficiale su GitHub. 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 software.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization Benefits)
(Real-world Use Cases)
(AI Integration Fundamentals)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
(Transport Mechanisms)
02. Security
::icon(fa fa-shield)
(AI-Specific Threats)
(Best Practices 2025)
(Azure Content Safety)
(Auth & Authorization)
(Microsoft Prompt Shields)
03. Getting Started
::icon(fa fa-rocket)
(First Server Implementation)
(Client Development)
(LLM Client Integration)
(VS Code Extensions)
(SSE Server Setup)
(HTTP Streaming)
(AI Toolkit Integration)
(Testing Frameworks)
(Deployment Strategies)
04. Practical Implementation
::icon(fa fa-code)
(Multi-Language SDKs)
(Testing & Debugging)
(Prompt Templates)
(Sample Projects)
(Production Patterns)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Agent Integration)
(Multi-modal AI Workflows)
(OAuth2 Authentication)
(Real-time Search)
(Streaming Protocols)
(Root Contexts)
(Routing Strategies)
(Sampling Techniques)
(Scaling Solutions)
(Security Hardening)
(Entra ID Integration)
(Web Search MCP)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Client Ecosystem)
(MCP Server Registry)
(Image Generation Tools)
(GitHub Collaboration)
07. Early Adoption
::icon(fa fa-lightbulb)
(Production Deployments)
(Microsoft MCP Servers)
(Azure MCP Service)
(Enterprise Case Studies)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance Optimization)
(Fault Tolerance)
(System Resilience)
(Monitoring & Observability)
09. Case Studies
::icon(fa fa-file-text)
(Azure API Management)
(AI Travel Agent)
(Azure DevOps Integration)
(Documentation MCP)
(GitHub MCP Registry)
(VS Code Integration)
(Real-world Implementations)
10. Hands-on Workshop
::icon(fa fa-laptop)
(MCP Server Fundamentals)
(Advanced Development)
(AI Toolkit Integration)
(Production Deployment)
(4-Lab Structure)
Il repository è organizzato in dieci sezioni principali, ciascuna focalizzata su diversi aspetti del MCP:
-
Introduzione (00-Introduction/)
- Panoramica del Protocollo di Contesto Modello
- Perché la standardizzazione è importante nei flussi di lavoro AI
- Casi d'uso pratici e benefici
-
Concetti Fondamentali (01-CoreConcepts/)
- Architettura client-server
- Componenti chiave del protocollo
- Modelli di messaggistica nel MCP
-
Sicurezza (02-Security/)
- Minacce alla sicurezza nei sistemi basati su MCP
- Migliori pratiche per implementazioni sicure
- Strategie di autenticazione e autorizzazione
- Documentazione Completa sulla Sicurezza:
- Migliori Pratiche di Sicurezza MCP 2025
- Guida all'Implementazione di Sicurezza su Azure
- Controlli e Tecniche di Sicurezza MCP
- Riferimento Rapido alle Migliori Pratiche MCP
- Argomenti Chiave sulla Sicurezza:
- Attacchi di iniezione di prompt e avvelenamento degli strumenti
- Furto di sessione e problemi di delega confusa
- Vulnerabilità nel passaggio di token
- Permessi eccessivi e controllo degli accessi
- Sicurezza della catena di approvvigionamento per componenti AI
- Integrazione con Microsoft Prompt Shields
-
Iniziare (03-GettingStarted/)
- Configurazione dell'ambiente
- Creazione di server e client MCP di base
- Integrazione con applicazioni esistenti
- Include sezioni su:
- Prima implementazione del server
- Sviluppo del client
- Integrazione con client LLM
- Integrazione con VS Code
- Server Server-Sent Events (SSE)
- Streaming HTTP
- Integrazione con AI Toolkit
- Strategie di test
- Linee guida per il deployment
-
Implementazione Pratica (04-PracticalImplementation/)
- Utilizzo di SDK in diversi linguaggi di programmazione
- Tecniche di debug, test e validazione
- Creazione di modelli di prompt e flussi di lavoro riutilizzabili
- Progetti di esempio con implementazioni pratiche
-
Argomenti Avanzati (05-AdvancedTopics/)
- Tecniche di ingegneria del contesto
- Integrazione con agenti Foundry
- Flussi di lavoro AI multi-modali
- Demo di autenticazione OAuth2
- Capacità di ricerca in tempo reale
- Streaming in tempo reale
- Implementazione di contesti radice
- Strategie di routing
- Tecniche di campionamento
- Approcci di scalabilità
- Considerazioni sulla sicurezza
- Integrazione di sicurezza Entra ID
- Integrazione con ricerca web
-
Contributi della Comunità (06-CommunityContributions/)
- Come contribuire con codice e documentazione
- Collaborazione tramite GitHub
- Miglioramenti e feedback guidati dalla comunità
- Utilizzo di vari client MCP (Claude Desktop, Cline, VSCode)
- Lavorare con server MCP popolari, inclusa la generazione di immagini
-
Lezioni dall'Adozione Iniziale (07-LessonsfromEarlyAdoption/)
- Implementazioni reali e storie di successo
- Creazione e deployment di soluzioni basate su MCP
- Tendenze e roadmap futura
- Guida ai Server MCP di Microsoft: Guida completa a 10 server MCP Microsoft pronti per la produzione, tra cui:
- Server MCP Microsoft Learn Docs
- Server MCP Azure (15+ connettori specializzati)
- Server MCP GitHub
- Server MCP Azure DevOps
- Server MCP MarkItDown
- Server MCP SQL Server
- Server MCP Playwright
- Server MCP Dev Box
- Server MCP Azure AI Foundry
- Server MCP Microsoft 365 Agents Toolkit
-
Migliori Pratiche (08-BestPractices/)
- Ottimizzazione delle prestazioni
- Progettazione di sistemi MCP tolleranti ai guasti
- Strategie di test e resilienza
-
Studi di Caso (09-CaseStudy/)
- Sette studi di caso completi che dimostrano la versatilità del MCP in scenari diversi:
- Agenti di Viaggio AI su Azure: Orchestrazione multi-agente con Azure OpenAI e AI Search
- Integrazione con Azure DevOps: Automazione dei processi di workflow con aggiornamenti di dati YouTube
- Recupero di Documentazione in Tempo Reale: Client console Python con streaming HTTP
- Generatore Interattivo di Piani di Studio: App web Chainlit con AI conversazionale
- Documentazione In-Editor: Integrazione con VS Code e flussi di lavoro GitHub Copilot
- Gestione API su Azure: Integrazione API aziendale con creazione di server MCP
- Registro MCP su GitHub: Sviluppo dell'ecosistema e piattaforma di integrazione agentica
- Esempi di implementazione che spaziano dall'integrazione aziendale alla produttività degli sviluppatori e allo sviluppo dell'ecosistema
-
Workshop Pratico (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Workshop pratico completo che combina MCP con AI Toolkit
- Creazione di applicazioni intelligenti che collegano modelli AI con strumenti reali
- Moduli pratici che coprono i fondamenti, lo sviluppo di server personalizzati e le strategie di deployment in produzione
- Struttura del Laboratorio:
- Lab 1: Fondamenti del Server MCP
- Lab 2: Sviluppo Avanzato del Server MCP
- Lab 3: Integrazione con AI Toolkit
- Lab 4: Deployment in Produzione e Scalabilità
- Approccio di apprendimento basato su laboratori con istruzioni passo-passo
Il repository include risorse di supporto:
- Cartella Immagini: Contiene diagrammi e illustrazioni utilizzati nel curriculum
- Traduzioni: Supporto multilingue con traduzioni automatiche della documentazione
- Risorse Ufficiali MCP:
- Apprendimento Sequenziale: Segui i capitoli in ordine (da 00 a 10) per un'esperienza di apprendimento strutturata.
- Focus su Linguaggi Specifici: Se sei interessato a un linguaggio di programmazione specifico, esplora le directory di esempio per implementazioni nel tuo linguaggio preferito.
- Implementazione Pratica: Inizia con la sezione "Iniziare" per configurare l'ambiente e creare il tuo primo server e client MCP.
- Esplorazione Avanzata: Una volta acquisita familiarità con le basi, approfondisci gli argomenti avanzati per ampliare le tue conoscenze.
- Coinvolgimento della Comunità: Unisciti alla comunità MCP tramite discussioni su GitHub e canali Discord per connetterti con esperti e altri sviluppatori.
Il curriculum copre vari client e strumenti MCP:
-
Client Ufficiali:
- Visual Studio Code
- MCP in Visual Studio Code
- Claude Desktop
- Claude in VSCode
- Claude API
-
Client della Comunità:
- Cline (basato su terminale)
- Cursor (editor di codice)
- ChatMCP
- Windsurf
-
Strumenti di Gestione MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Il repository introduce vari server MCP, tra cui:
-
Server MCP Ufficiali di Microsoft:
- Server MCP Microsoft Learn Docs
- Server MCP Azure (15+ connettori specializzati)
- Server MCP GitHub
- Server MCP Azure DevOps
- Server MCP MarkItDown
- Server MCP SQL Server
- Server MCP Playwright
- Server MCP Dev Box
- Server MCP Azure AI Foundry
- Server MCP Microsoft 365 Agents Toolkit
-
Server di Riferimento Ufficiali:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Generazione di Immagini:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Strumenti di Sviluppo:
- Git MCP
- Controllo Terminale
- Assistente Codice
-
Server Specializzati:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Questo repository accoglie contributi dalla comunità. Consulta la sezione Contributi della Comunità per indicazioni su come contribuire efficacemente all'ecosistema MCP.
| Data | Modifiche |
|---|---|
| 26 settembre 2025 | - Aggiunto studio di caso GitHub MCP Registry alla sezione 09-CaseStudy - Aggiornati gli studi di caso per riflettere sette studi completi - Migliorate le descrizioni degli studi di caso con dettagli specifici di implementazione - Aggiornata la Mappa Visiva del Curriculum per includere GitHub MCP Registry - Rivista la struttura della guida allo studio per riflettere il focus sullo sviluppo dell'ecosistema |
| 18 luglio 2025 | - Aggiornata la struttura del repository per includere la Guida ai Server MCP di Microsoft - Aggiunta lista completa di 10 server MCP Microsoft pronti per la produzione - Migliorata la sezione Server MCP Popolari con Server MCP Ufficiali di Microsoft - Aggiornata la sezione Studi di Caso con esempi di file reali - Aggiunti dettagli sulla Struttura del Laboratorio per il Workshop Pratico |
| 16 luglio 2025 | - Aggiornata la struttura del repository per riflettere i contenuti attuali - Aggiunta la sezione Client e Strumenti MCP - Aggiunta la sezione Server MCP Popolari - Aggiornata la Mappa Visiva del Curriculum con tutti gli argomenti attuali - Migliorata la sezione Argomenti Avanzati con tutte le aree specializzate - Aggiornata la sezione Studi di Caso per riflettere esempi reali - Chiarita l'origine del MCP come creato da Anthropic |
| 11 giugno 2025 | - Creazione iniziale della guida allo studio - Aggiunta Mappa Visiva del Curriculum - Struttura del repository delineata - Inclusi progetti di esempio e risorse aggiuntive |
Questa guida allo studio è stata aggiornata il 26 settembre 2025 e offre una panoramica del repository a quella data. I contenuti del repository potrebbero essere aggiornati dopo questa data.