Estructura de proyecto para un servidor
Organice los archivos para que su servidor pueda crecer fácilmente.
Estructura de proyecto para un servidor es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.
La estructura le prepara para crecer
Un servidor pequeño cabe en un solo archivo, pero una buena organización permite que crezca sin convertirse en un desastre. Un poco de planificación ahora le ahorrará muchos problemas después. 🗂️
Empiece con un archivo
La mayoría de los servidores comienzan como un único server.py. Contiene la instancia de FastMCP y una o dos herramientas, más que suficiente para empezar.
pyproject.toml es el mapa
En la raíz se encuentra pyproject.toml, donde se declaran el nombre del proyecto y sus dependencias. uv lo lee para saber exactamente qué debe instalar.
El archivo de bloqueo permanece
Justo a su lado se encuentra uv.lock, el registro con las versiones exactas resueltas. Confírmelo en el repositorio para que sus compañeros puedan reproducir exactamente su configuración.
Mantenga .venv fuera de Git
La carpeta .venv se genera automáticamente; no es código fuente. Añádala a .gitignore para no confirmar nunca un entorno pesado y específico de una máquina.
.venv/
__pycache__/Agrupe por primitiva
A medida que el proyecto crezca, separe el código según su función. Colocar tools, recursos y prompts en módulos independientes mantiene cada archivo centrado y fácil de leer.
Un árbol habitual
Un servidor en crecimiento suele tener este aspecto: un punto de entrada junto a una carpeta para cada tipo de capacidad. Las carpetas claras permiten desplazarse rápidamente por el proyecto. 🌳
my-server/
server.py
tools/
resources/
prompts/Un único punto de entrada
Mantenga un único punto de entrada que cree la instancia de FastMCP y registre todos los elementos. Los clientes solo tendrán que iniciar este archivo.
Importe, no lo incluya directamente
Defina las herramientas en sus propios módulos y después impórtelas y regístrelas en el archivo de entrada. Así, su server.py se mantiene breve y fácil de revisar.
from tools.math import register_math
register_math(mcp)Añada un README
Un README breve que explique a otras personas cómo instalar y ejecutar su servidor facilita compartirlo. Su yo del futuro se lo agradecerá a su yo actual.
Mantenga los secretos fuera
No incluya nunca claves directamente en el código. Lévalas desde variables de entorno y conserve un .env de ejemplo para mantener la configuración segura y portable. 🔐
Comprobación rápida
Está decidiendo qué confirmar en el control de versiones.
Una estructura que puede crecer
Ha aprendido a empezar con un archivo, mantener pyproject.toml y el archivo de bloqueo bajo seguimiento, ignorar .venv y separar el código por primitiva. Su servidor puede crecer de forma ordenada. ✅
Preguntas frecuentes
¿La lección «Estructura de proyecto para un servidor» es gratis?
Sí — el texto completo de «Estructura de proyecto para un servidor» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Estructura de proyecto para un servidor»?
Organice los archivos para que su servidor pueda crecer fácilmente. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar MCP Academy?
No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Estructura de proyecto para un servidor»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de MCP Academy?
Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Instalar Python y uv
- Añadir el SDK de MCP para Python
- Conozca la CLI de mcp
- Estructura de proyecto para un servidor