M脫DULO 07: Integracion FastMCP en FastAPI 馃搳馃敊馃敋
FastMCP es un framework construido sobre el SDK oficial de Model Context Protocol (MCP), desarrollado por Anthropic. Su prop贸sito es permitir la creaci贸n de servidores MCP capaces de exponer herramientas, recursos o datos para que clientes MCP (como Claude u otros agentes compatibles) puedan interactuar con ellos.
Lo m谩s interesante de FastMCP es que puede funcionar de forma independiente o integrarse dentro de aplicaciones FastAPI, lo cual permite combinar el poder del protocolo MCP con la flexibilidad, seguridad y estructura modular de FastAPI.
鈿欙笍 驴Por qu茅 FastAPI es ideal para integrar FastMCP?
FastAPI es uno de los frameworks m谩s potentes y modernos en el ecosistema Python, el cu谩l permite construir APIs escalables, seguras y con tipado completo de datos. Su naturaleza as铆ncrona lo hace perfectamente compatible con el modelo ASGI (Asynchronous Server Gateway Interface), que es la base sobre la cual se ejecuta FastMCP.
Por debajo, FastAPI utiliza Starlette como su motor ASGI, esto significa que, aunque la infraestructura t茅cnica provenga de Starlette, todo el ecosistema de FastAPI (rutas, middlewares, dependencias, autenticaci贸n, documentaci贸n autom谩tica, etc.) puede convivir perfectamente con FastMCP.
Por otro lado, Starlette se caracteriza por ser:
Extremadamente ligero y r谩pido.
Base sobre la cual se construye FastAPI.
Ideal para manejar rutas personalizadas (custom routes) y servidores HTTP as铆ncronos.
馃Л Si quieres aprender a crear una API desde cero en FastAPI antes de integrar FastMCP, revisa mi serie Creando una API desde cero con FastAPI, que est谩 pr贸xima a culminar.
馃彚 Nested Mounts (Montajes Anidados)
Los nested mounts son una caracter铆stica avanzada de FastMCP que permiten montar varios servidores MCP dentro de un mismo framework (FastAPI).
Cada servidor MCP puede tener:
Sus propios recursos (resources).
Sus propias tools (herramientas).
Sus propios prompts o configuraciones.
Esto permite:
Exponer m煤ltiples servidores bajo distintas rutas.
Escalar sistemas con diferentes prop贸sitos (por ejemplo, uno para documentos internos y otro para datos financieros).
Crear arquitecturas modulares y f谩cilmente mantenibles.
Para m谩s detalle verificar el video: Explicacion Integracion FastAPI y el archivo: 07_integration_fastapi_mcp_fastmcp.py
馃懁馃攼Servidores autenticados
FastMCP puede integrarse con sistemas de autenticaci贸n (tokens, OAuth2, headers, etc.) al montarse sobre FastAPI. Esto garantiza que solo clientes autorizados puedan acceder a los recursos MCP expuestos.
Ejemplo de autenticaci贸n simple con token:
Esto garantiza que solo las solicitudes con el header adecuado puedan acceder al servidor MCP.
鈾撅笍 Integraci贸n pr谩ctica y escalabilidad
Gracias a su compatibilidad con FastAPI, FastMCP puede:
Integrarse en sistemas empresariales complejos, donde distintos m贸dulos MCP exponen partes de informaci贸n o servicios internos.
Mantener la seguridad interna de los recursos sin necesidad de publicarlos en Internet.
Escalar horizontalmente (a帽adiendo m谩s servidores MCP seg煤n las necesidades).
Servir simult谩neamente a clientes internos (por API) y externos (por MCP clients).
鉁嶏笍 En conclusi贸n
Concepto | Descripci贸n |
Starlette | Framework ASGI ligero que sirve como base de FastAPI y motor de ejecuci贸n de FastMCP. |
FastMCP | Framework que implementa el protocolo MCP para crear servidores que exponen recursos, tools y prompts. |
Custom Routes | Rutas personalizadas para extender las capacidades de un servidor FastMCP. |
Nested Mounts | T茅cnica que permite montar varios servidores MCP dentro de un mismo framework. |
Autenticaci贸n | Mecanismos (token, OAuth, middleware) para proteger el acceso a los servidores MCP. |
Integraci贸n | FastMCP puede montarse dentro de Starlette o FastAPI, combinando capacidades web y de IA. |
Comentarios