Struttura del progetto per un server
Organizzi i file in modo che il Suo server sia facile da ampliare.
Struttura del progetto per un server è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 4 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.
La struttura prepara il progetto alla crescita
Un server piccolo può stare in un solo file, ma una buona struttura gli permette di crescere senza trasformarsi in un disordine. Un po' di pianificazione ora evita problemi concreti in seguito. 🗂️
Cominci da un solo file
La maggior parte dei server nasce come un singolo file server.py. Contiene l'istanza FastMCP e uno o due strumenti: quanto basta per iniziare.
pyproject.toml è la mappa
Nella radice si trova pyproject.toml, che dichiara il nome del progetto e le sue dipendenze. uv lo legge per sapere esattamente che cosa installare.
Il lockfile rimane invariato
Accanto ad esso si trova uv.lock, il registro che fissa ogni versione risolta. Lo includa nel commit, così i colleghi potranno ricreare esattamente la Sua configurazione.
Escluda .venv da Git
La cartella .venv viene generata e non contiene codice sorgente. La aggiunga a .gitignore per non inserire mai nel repository un ambiente pesante e specifico della macchina.
.venv/
__pycache__/Raggruppi per primitiva
Man mano che il progetto cresce, separi il codice in base alla sua funzione. Collocare tools, risorse e prompt in moduli distinti mantiene ogni file focalizzato e leggibile.
Un albero tipico
Un server in crescita spesso ha questo aspetto: un punto di ingresso accanto a una cartella per ogni tipo di funzionalità. Cartelle chiare permettono di spostarsi rapidamente nel progetto. 🌳
my-server/
server.py
tools/
resources/
prompts/Un unico punto di ingresso
Mantenga un solo entry point che crei l'istanza FastMCP e registri ogni elemento. Ai client basta avviare questo unico file.
Importi, non inserisca tutto nel file
Definisca gli strumenti nei rispettivi moduli, quindi li importi e li registri nel file di ingresso. Il Suo server.py rimane breve e facile da consultare.
from tools.math import register_math
register_math(mcp)Aggiunga un README
Un breve README che spiega agli altri come installare ed eseguire il server lo rende facile da condividere. Il Suo futuro sé La ringrazierà.
Mantenga i segreti all'esterno
Non inserisca mai le chiavi direttamente nel codice. Le legga dalle variabili d'ambiente e mantenga un file .env di esempio, così la configurazione rimane sicura e portabile. 🔐
Verifica rapida
Sta decidendo che cosa includere nel controllo versione.
Una struttura che cresce con il progetto
Ha imparato a iniziare con un solo file, mantenere sotto controllo versione pyproject.toml e il lockfile, ignorare .venv e separare il codice per primitiva. Il server può crescere in modo ordinato. ✅
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Struttura del progetto per un server» è gratuita?
Sì — il testo completo di «Struttura del progetto per un server» è 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 «Struttura del progetto per un server»?
Organizzi i file in modo che il Suo server sia facile da ampliare. 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 4 di 4.
Quanto tempo richiede la lezione «Struttura del progetto per un server»?
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
- Installare Python e uv
- Aggiungere l'SDK Python di MCP
- Conoscere la CLI mcp
- Struttura del progetto per un server