FastMCP

---

El Model Context Protocol (MCP) conecta LLMs con herramientas y datos. FastMCP es un framework completo de aplicaciones MCP para servidores, clientes y aplicaciones interactivas. Un servidor comienza con Python ordinario:

from fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

@mcp.tool
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

if __name__ == "__main__":
    mcp.run()

Por qué FastMCP

Construir una aplicación MCP efectiva es más difícil de lo que parece. FastMCP se encarga de todo. Declara una herramienta con una función de Python, y el esquema, la validación y la documentación se generan automáticamente. Conéctate a un servidor con una URL, y la negociación de transporte, la autenticación y el ciclo de vida del protocolo se gestionan por ti. Tú te enfocas en tu lógica, y la parte de MCP simplemente funciona: con FastMCP, las mejores prácticas están integradas.

Por eso FastMCP es el framework estándar para trabajar con MCP. FastMCP 1.0 se incorporó al SDK oficial de MCP para Python en 2024. Hoy, el proyecto independiente mantenido activamente se descarga un millón de veces al día, y alguna versión de FastMCP impulsa el 70% de los servidores MCP en todos los lenguajes.

FastMCP tiene tres pilares:

Servidores Expón herramientas, recursos y prompts a los LLMs.

Aplicaciones Dale a tus herramientas interfaces de usuario interactivas renderizadas directamente en la conversación.

Clientes Conéctate a cualquier servidor MCP — local o remoto, programático o CLI.

Servidores envuelven tus funciones de Python en herramientas, recursos y prompts compatibles con MCP. Clientes se conectan a cualquier servidor con soporte completo del protocolo. Y Aplicaciones dan a tus herramientas interfaces de usuario interactivas renderizadas directamente en la conversación.

¿Construyendo en TypeScript? FastMCP para TypeScript es la contraparte oficial, construida y mantenida por el mismo equipo. Mismos pilares, mismas ideas, npm install @prefecthq/fastmcp-ts.

¿Listo para construir? Comienza con la guía de instalación o salta directamente al inicio rápido.

Escala MCP con Horizon

FastMCP maneja la capa de aplicación MCP. Prefect Horizon es la puerta de enlace MCP empresarial para escalar servidores y herramientas entre equipos, con gobernanza centralizada sobre cómo se despliegan, descubren, aseguran y utilizan.

FastMCP y Horizon son construidos por el mismo equipo en Prefect.

Despliega servidores FastMCP desde GitHub con vistas previas de ramas y reversión instantánea. Crea un registro privado de cada MCP que tu empresa use. Asegura el acceso con SSO y RBAC a nivel de herramienta. Obtén registros de auditoría, observabilidad y gobernanza en tu pila MCP. Remezcla herramientas aprobadas en endpoints diseñados para equipos y agentes.

Comienza con FastMCP. Escala con Horizon →

Instalación

Recomendamos añadir FastMCP a tu proyecto con uv:

uv add fastmcp

Para instrucciones completas de instalación, incluyendo verificación y actualización, consulta la Guía de Instalación.

¿Actualizando? Tenemos guías para:

• Actualizar desde FastMCP 3
• Actualizar desde FastMCP 2
• Actualizar desde MCP SDK v1 o v2
• Actualizar desde el SDK de bajo nivel v1 o v2

📚 Documentación

La documentación completa de FastMCP está disponible en gofastmcp.com, incluyendo guías detalladas, referencias de API y patrones avanzados.

La documentación también está disponible en formato llms.txt, que es un estándar simple de markdown que los LLMs pueden consumir fácilmente:

• llms.txt es esencialmente un mapa del sitio, que lista todas las páginas de la documentación.
• llms-full.txt contiene toda la documentación. Ten en cuenta que esto puede exceder la ventana de contexto de tu LLM.

Comunidad: Únete a nuestro servidor de Discord para conectar con otros desarrolladores de FastMCP y compartir lo que estás construyendo.

Contribuciones

Comienza con CONTRIBUTING.md para contribuciones aceptadas y el flujo de trabajo de asignación de issues, luego sigue la Guía de Contribuciones para configuración y validación. Los agentes deben leer AGENTS.md.