FastMCP: La guía completa para crear servidores y clientes de MCP

FastMCP: La guía completa para crear servidores y clientes de MCP

Un completo tutorial sobre FastMCP 2.0, la forma rápida y "pythónica" de construir servidores y clientes basados en el Protocolo de Contexto del Modelo (MCP). Aprende a crear herramientas, recursos e instrucciones para tus aplicaciones LLM.

Lección 1 2025-07-03 06:56

Introducción a FastMCP y al Protocolo de Contexto del Modelo

Introducción a FastMCP y al Protocolo de Contexto de Modelo

¿Qué es el Protocolo de Contexto de Modelo (MCP)?

El Protocolo de Contexto de Modelo (MCP) es una forma estandarizada y revolucionaria de proporcionar contexto y herramientas a los Grandes Modelos de Lenguaje (LLM). A menudo descrito como "el puerto USB-C para la IA", MCP proporciona una interfaz uniforme para conectar los LLM a recursos y funcionalidades externos.

Piensa en MCP como una API especializada diseñada específicamente para interacciones con LLM. Los servidores MCP pueden:

  • Exponer datos a través de Recursos (similar a los puntos finales GET para cargar información).
  • Proporcionar funcionalidad a través de Herramientas (similar a los puntos finales POST para ejecutar acciones).
  • Definir patrones de interacción a través de Prompts (plantillas reutilizables para conversaciones con LLM).
  • Gestionar conexiones de forma segura y eficiente.

¿Por qué FastMCP?

Crear servidores MCP desde cero implica una cantidad significativa de código repetitivo e infraestructura básica: configuración del servidor, manejadores de protocolo, gestión de tipos de contenido y manejo de errores. FastMCP elimina esta complejidad al proporcionar una interfaz Pythonica de alto nivel que te permite concentrarte en construir una gran funcionalidad.

FastMCP 2.0 es la versión mantenida activamente que va mucho más allá de la implementación básica del protocolo. Ofrece:

🚀 Desarrollo Rápido: Una interfaz de alto nivel significa menos código y un desarrollo más veloz. 🍀 API Sencilla: Permite construir servidores MCP con una mínima cantidad de código base. 🐍 Diseño Pythonico: Se siente natural para los desarrolladores de Python. 🔍 Plataforma Completa: Un kit de herramientas exhaustivo desde el desarrollo hasta la producción.

Características de FastMCP

Capacidades principales

  • Creación sencilla de servidores: Crea servidores MCP con solo unas pocas líneas de código.
  • Diseño basado en decoradores: Decoradores simples para convertir funciones en herramientas MCP.
  • Soporte de múltiples transportes: Transportes STDIO, HTTP y SSE.
  • Seguridad de tipos: Generación automática de esquemas a partir de sugerencias de tipos de Python.
  • Soporte asíncrono: Soporte completo para funciones síncronas y asíncronas.

Características avanzadas

  • Composición de servidores: Monta múltiples servidores juntos.
  • Servidores proxy: Crea servidores intermediarios para servicios MCP existentes.
  • Autenticación: Seguridad integrada para implementaciones en producción.
  • Integración con OpenAPI: Genera servidores a partir de API REST existentes.
  • Librerías cliente: Soporte completo para clientes para pruebas e integración.

Un ejemplo sencillo

Veamos lo fácil que es crear un servidor MCP básico con FastMCP:

from fastmcp import FastMCP

# Crea una instancia de servidor
mcp = FastMCP("Servidor Demostración 🚀")

@mcp.tool
def sumar_numeros(a: int, b: int) -> int:
    """Suma dos números."""
    return a + b

@mcp.tool
def saludar_usuario(nombre: str) -> str:
    """Saluda a un usuario por su nombre."""
    return f"¡Hola, {nombre}! ¡Bienvenido a FastMCP!"

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

¡Eso es todo! Esto crea un servidor MCP completamente funcional con dos herramientas que pueden ser llamadas por cualquier cliente MCP.

Próximos pasos

En las siguientes secciones, profundizaremos en: - Configuración de tu entorno de desarrollo FastMCP. - Creación de herramientas y recursos sofisticados. - Construcción de servidores listos para producción. - Integración con Claude Code y otros clientes MCP. - Patrones avanzados y mejores prácticas.

FastMCP hace que el potente Protocolo de Contexto de Modelo sea accesible para los desarrolladores de Python, lo que te permite construir sofisticadas aplicaciones impulsadas por IA con el mínimo esfuerzo.