Arquitectura de servidor por capas
Separe el transporte, los controladores y la lógica de negocio.
Arquitectura de servidor por capas es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 1 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.
Por qué perjudica un archivo enorme
Un servidor concentrado en un solo archivo mezcla el transporte, la lógica de las herramientas y las llamadas a los datos. A medida que crece, cada cambio puede romper algo muy alejado.
Piense en capas
Un servidor bien diseñado se divide en capas: el transporte en el extremo, los controladores de MCP en el centro y la lógica de negocio pura debajo.
La capa de transporte
La capa externa de transporte solo mueve mensajes, mediante stdio o HTTP. No debería saber nada sobre lo que hacen realmente sus herramientas.
Los controladores son adaptadores delgados
Los controladores de sus herramientas y recursos deben ser delgados: analizar los argumentos, llamar a un servicio y dar forma al resultado. Mantenga el trabajo real fuera de ellos.
@mcp.tool()
def summarize(text: str) -> str:
return service.summarize(text)La capa de servicios hace el trabajo
Coloque la lógica real en un módulo service sencillo, sin imports de MCP. Es simplemente código Python normal que puede llamar desde cualquier lugar.
def summarize(text: str) -> str:
return shorten(clean(text))Por qué resulta útil dividirlo
Al desacoplar la lógica de MCP, puede probarla sin iniciar un servidor y reutilizarla más adelante en una CLI o una aplicación web.
Las dependencias apuntan hacia dentro
Mantenga esta regla unidireccional: los controladores pueden importar servicios, pero los servicios nunca deben importar controladores ni el transporte que está por encima.
Una carpeta por responsabilidad
Asigne las capas a carpetas para que la estructura explique el diseño: la entrada del servidor, los controladores, los servicios y los modelos deben tener cada uno su propio lugar.
src/
server.py
handlers/
services/
models.pyRegistre, no defina, en la entrada
Su archivo server.py debe conectar los controladores con la instancia de FastMCP, no contener lógica. Es un punto de ensamblaje, no el encargado del trabajo.
from handlers import register_tools
register_tools(mcp)Los auxiliares transversales se comparten
Los registros, la configuración y la validación son aspectos compartidos. Deles un módulo común para que todas las capas utilicen los mismos auxiliares.
Crezca sin reescribirlo todo
La arquitectura por capas permite que el servidor escale en tamaño: añada una herramienta nueva incorporando un controlador y un servicio, sin modificar nada más.
Comprobación rápida
¿Dónde debe residir la lógica de negocio real de una herramienta?
Repaso: diseño por capas
Divida su servidor en transporte, controladores delgados y servicios puros, con las dependencias apuntando hacia dentro. Siguiente tema: configuración. 🧱
Aprende Python con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 30
- Lecciones
- 120
Preguntas frecuentes
¿La lección «Arquitectura de servidor por capas» es gratis?
Sí — el texto completo de «Arquitectura de servidor por capas» 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 «Arquitectura de servidor por capas»?
Separe el transporte, los controladores y la lógica de negocio. 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 1 de 4.
¿Cuánto tiempo toma la lección «Arquitectura de servidor por capas»?
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
- Arquitectura de servidor por capas
- Configuración y secretos mediante el entorno
- Herramientas idempotentes y conscientes de sus efectos secundarios
- Versionar herramientas y esquemas