MÓDULO 11 — Arquitectura MCP en FastMCP 🌐

Brayan Neciosup
10 dic
2 Min. de lectura

Construyendo la base para servidores MCP escalables

En este capítulo de mi FastMCP Learning Journey, presento la primera versión de mi propuesta de arquitectura para servidores basados en el Model Context Protocol (MCP) utilizando el framework FastMCP.

Mi objetivo al diseñarla fue simple: crear una estructura clara, modular y preparada para crecimiento real, algo que no suele encontrarse en los ejemplos existentes.

🎯 Propósito de esta arquitectura

Durante mi investigación encontré que muchos repositorios muestran ejemplos funcionales, pero pocas veces explican cómo organizar un proyecto MCP de forma profesional. Por eso, esta arquitectura busca resolver preguntas como:

¿Cómo separar responsabilidades dentro del servidor MCP?
¿Cómo organizar tools, prompts, resources y rutas personalizadas?
¿Dónde deben vivir configuraciones y credenciales?
¿Cómo preparar el proyecto para integrar proxys, servers compuestos y APIs externas?

El resultado es una arquitectura modular, entendible y adaptable.

📌 Alcance de esta versión (V1)

Esta versión se centra exclusivamente en servidores MCP construidos con FastMCP. Aún no incluye:

❌ Clientes MCP

Pero sí deja el terreno preparado para incorporarlos más adelante.

🧩 Componentes principales del proyecto

La arquitectura final organiza el proyecto en módulos como:

assets/ → datasets y archivos internos
core/ → configuración, entorno, seguridad y utilidades globales
server_mcp/ → núcleo del servidor (tools, prompts, resources, custom routes)
main.py → entrypoint del servidor

Este ordenamiento permite crecer sin perder claridad ni escalabilidad.

🔮 Módulos avanzados (pensados para futuras versiones)

También definí espacios para expansión futura:

Composing Servers: combinar múltiples servidores MCP
Integration Frameworks: adaptación hacia FastAPI, LangChain, Flask, etc.
MCP Proxys: para enrutar tráfico entre múltiples servidores
Integración con APIs externas

El módulo de MCP Proxys no está activo aún, pero ya cuenta con su lugar dentro de la arquitectura para cuando el proyecto evolucione.

⚡ La importancia de uv en esta arquitectura

Gracias a uv, la base del proyecto nace limpia y ordenada:archivo de dependencias, lockfile, estructura mínima y un punto de entrada bien definido. Esto acelera el desarrollo y reduce fricción al momento de escalar.