FastMCP: publica herramientas Python para agentes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: intermedio
• Proyecto: https://github.com/PrefectHQ/fastmcp (licencia Apache-2.0)
• Guía completa: https://lab.wisd.ai/hub/fastmcp

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que tienes Python ≥3.10, uv y un proyecto Python inicializado. Desde su raíz, instala con el comando del README:

uv add fastmcp

Guarda como server.py su ejemplo mínimo:

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(transport="http", port=8000)

Comprobación

Desde la raíz, inicia el servidor en una terminal con uv run python server.py. En la misma carpeta guarda client.py, adaptando el cliente del tutorial oficial a la herramienta add:

import asyncio
from fastmcp import Client

async def main():
    async with Client("http://localhost:8000/mcp") as client:
        result = await client.call_tool("add", {"a": 2, "b": 3})
        print(result)

asyncio.run(main())

En otra terminal, desde la misma raíz, ejecuta uv run python client.py. Comprueba que la respuesta contiene 5. Mantén el servidor activo durante la llamada y detenlo con Ctrl+C al terminar.

Si algo falla

Revisa el transporte del cliente y los registros del servidor antes de añadir servicios externos.