MÓDULO 10: Integración de APIs en FastMCP

Brayan Neciosup
28 nov
3 Min. de lectura

El concepto clave aquí es que FastMCP puede actuar como un puente entre APIs tradicionales (HTTP/OpenAPI) y el protocolo MCP, que es más moderno, orientado a herramientas, prompts, y contextos semánticos.

Por eso existen dos direcciones de integración principales dentro del ecosistema:

De una API (o framework) → a un servidor MCP (Generar un servidor MCP desde una API ya existente, usando su especificación OpenAPI)
De un servidor MCP → integrando una API FastAPI dentro de él (Extender un servidor MCP con endpoints HTTP y lógica FastAPI adicional)

Aunque suenen parecidas, son completamente diferentes en propósito y flujo. Vamos a explicarlas por separado 👇

1. OpenAPI Integration (Generar un servidor MCP desde una API existente)

🧠 Concepto

Este modo de integración es conocido como: "From OpenAPI to MCP"

En este escenario, ya existe una API REST construida con cualquier framework o lenguaje (FastAPI, Express.js, Flask, Spring Boot, etc.), y tú quieres convertirla en un servidor MCP o exponerla como si fuera un servidor MCP.

Lo que hace FastMCP aquí es interpretar la especificación OpenAPI de esa API (el documento JSON o YAML que describe sus endpoints, parámetros, métodos, etc.) y convertir automáticamente cada endpoint en una “tool” MCP.

En otras palabras: "Cada endpoint HTTP se convierte en una herramienta MCP utilizable por un cliente MCP."

🧩 Ejemplo conceptual

Supongamos que tienes una API en Node.js con esta ruta:

Y su documentación OpenAPI (por ejemplo openapi.json) ya está publicada. FastMCP puede leer esa especificación y crear un servidor MCP automático:

👉 Resultado:

Ya no necesitas reescribir tu API.
Cada endpoint (/users, /users/{id}) se convierte en una “tool” MCP.
Tu API ahora puede ser usada directamente por clientes MCP (como ChatGPT, Claude, etc.), que interpretan esas herramientas desde tu servidor MCP generado.

Para más detalle verificar el video: Explicacion OpenAPI y el archivo: openapi_integration.py

🧰 Usos Prácticos

Reutilizar APIs existentes sin tener que desarrollar lógica MCP desde cero.
Integrar microservicios REST dentro de ecosistemas MCP.
Automatizar herramientas conversacionales desde APIs tradicionales.

🧱 Ventajas

Conversión directa y rápida desde APIs REST a MCP.
Compatible con cualquier lenguaje o framework (no solo Python).
Ideal para interoperabilidad entre sistemas legados y el nuevo protocolo MCP.

⚠️ Limitaciones

No puedes personalizar el comportamiento interno de las herramientas, ya que son generadas automáticamente.
Dependes completamente de la calidad y precisión de la especificación OpenAPI.
No aprovechas toda la riqueza de FastMCP (prompts, recursos, herramientas personalizadas, etc.), salvo que extiendas el servidor manualmente.

⚙️ 2. FastAPI Integration (FastAPI convertido en un servidor MCP)

🧠 Concepto

Aquí una API desarrollada en FastAPI puede convertirse en un servidor FastMCP corriendo (con herramientas, recursos y prompts definidos) “De FastAPI hacia MCP”.

🧩 Ejemplo

👉 Aquí:

Tu servidor MCP sigue siendo el principal.
Pero ahora también expone endpoints FastAPI (por ejemplo /status, /login, /docs, etc.).
Puedes usar esta integración para construir paneles de administración, rutas de monitoreo, o incluso interfaces web para tu servidor MCP.

Para más detalle verificar el video: Explicacion FastAPI y el archivo: fastapi_integration.py

🧰 Usos prácticos

Añadir endpoints de administración o salud (/health, /status).
Integrar autenticación HTTP antes de acceder al MCP.
Exponer recursos adicionales (logs, estadísticas, configuración, etc.).
Crear un gateway híbrido MCP + REST dentro del mismo proceso.

🧱 Ventajas

Extiendes la funcionalidad de tu servidor MCP sin alterar su núcleo.
Puedes aprovechar el ecosistema completo de FastAPI (middlewares, autenticación, dependencias, etc.).
Mantienes la coherencia del entorno ASGI, ya que ambos frameworks son compatibles.

⚠️ Limitaciones

Tu servidor MCP se vuelve más complejo al combinar dos lógicas (MCP + REST).
Debes cuidar las rutas montadas (/mcp, /api, etc.) para evitar conflictos.

🧩 Conclusión

Ambas integraciones representan puentes distintos entre el mundo REST y el mundo MCP, pero sirven para fines complementarios:

🧱 OpenAPI Integration te permite elevar una API existente al ecosistema MCP, dándole una nueva vida sin reescribirla.
🧩 FastAPI Integration te permite enriquecer tu servidor MCP con capacidades REST tradicionales, manteniendo compatibilidad ASGI.

En resumen:

"Ambos transforman APIs en servidores MCP" permitendo que FastMCP se convierta en un framework totalmente interoperable con el mundo actual de las APIs, sin importar el lenguaje o el protocolo.