Architettura server a livelli
Separi trasporto, handler e logica di business.
Architettura server a livelli è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Perché un unico file enorme è un problema
Un server concentrato in un solo file mescola trasporto, logica degli strumenti e accesso ai dati. Con la crescita del progetto, ogni modifica rischia di danneggiare qualcosa di molto lontano.
Pensare per livelli
Un server ben strutturato è suddiviso in livelli: il trasporto al bordo, i gestori MCP al centro e la logica di business pura alla base.
Il livello di trasporto
Il trasporto esterno si limita a spostare messaggi tramite stdio o HTTP. Non dovrebbe sapere nulla di ciò che fanno realmente gli strumenti.
I gestori sono adattatori sottili
I gestori di strumenti e risorse devono essere sottili: analizzano gli argomenti, chiamano un servizio e modellano il risultato. Lasci il lavoro vero al di fuori di essi.
@mcp.tool()
def summarize(text: str) -> str:
return service.summarize(text)Il livello dei servizi esegue il lavoro
Inserisca la logica effettiva in un normale modulo service privo di import MCP. È semplice codice Python, richiamabile da qualsiasi punto.
def summarize(text: str) -> str:
return shorten(clean(text))Perché la separazione conviene
Con la logica disaccoppiata da MCP, può testarla senza avviare un server e riutilizzarla in seguito in una CLI o in un'app web.
Le dipendenze puntano verso l'interno
Mantenga questa regola unidirezionale: i gestori possono importare i servizi, ma i servizi non devono mai importare i gestori o il trasporto sovrastante.
Una cartella per ogni responsabilità
Rappresenti i livelli con cartelle, in modo che la struttura racconti la storia: ingresso del server, gestori, servizi e modelli hanno ciascuno il proprio spazio.
src/
server.py
handlers/
services/
models.pyRegistrare, non definire, nell'ingresso
Il file server.py dovrebbe collegare i gestori all'istanza FastMCP, non contenere la logica. È un punto di assemblaggio, non il motore del lavoro.
from handlers import register_tools
register_tools(mcp)Mantenere condivisi gli helper trasversali
Logging, configurazione e validazione sono aspetti condivisi. Li riunisca in un modulo comune, così ogni livello usa gli stessi helper.
Crescere senza riscrivere
La suddivisione in livelli consente al server di scalare in dimensioni: per aggiungere un nuovo strumento basta aggiungere un gestore e un servizio, lasciando invariato tutto il resto.
Verifica rapida
Dove dovrebbe risiedere la vera logica di business di uno strumento?
Riepilogo: progettazione a livelli
Divida il server in trasporto, gestori sottili e servizi puri, con dipendenze dirette verso l'interno. Prossimo argomento: configurazione. 🧱
Domande Frequenti
La lezione «Architettura server a livelli» è gratuita?
Sì — il testo completo di «Architettura server a livelli» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Architettura server a livelli»?
Separi trasporto, handler e logica di business. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.
Quanto tempo richiede la lezione «Architettura server a livelli»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Architettura server a livelli
- Configurazione e segreti tramite l'ambiente
- Strumenti idempotenti e consapevoli degli effetti collaterali
- Versionare strumenti e schemi