Cuando las API requieren autenticación
Cuando una API externa requiere una clave de API, la clave debe estar en el entorno del servidor y añadirse solo en la cabecera de la petición saliente. El cliente nunca envía ni recibe la clave. En este ejercicio vas a añadir compatibilidad opcional con clave de API a la herramienta convert_currency del servidor de divisas.
La Frankfurter API no requiere clave para un uso básico, pero muchas API sí. Leerás una clave opcional del entorno (p. ej., CURRENCY_API_KEY) y, si existe, la añadirás a la solicitud como una cabecera Authorization: Bearer.
Ya se ha instanciado un servidor MCP y se ha guardado en la variable mcp. El módulo os ya se ha importado por ti.
Este ejercicio forma parte del curso
Introducción a Model Context Protocol (MCP)
Instrucciones del ejercicio
- Lee la clave de API
"CURRENCY_API_KEY"de las variables de entorno y añádela a la cabecera"Authorization"con el valor"Bearer "más la clave en la solicitud. - Pasa las cabeceras en la petición GET a la API.
ejercicio interactivo práctico
Prueba este ejercicio completando este código de ejemplo.
@mcp.tool()
def convert_currency(amount: float, from_currency: str, to_currency: str) -> str:
"""Convert an amount from one currency to another using current exchange rates."""
url = f"https://api.frankfurter.dev/v1/latest?base={from_currency}&symbols={to_currency}"
# Read optional API key from the server's environment
headers = {}
api_key = os.environ.get(____)
if api_key:
headers["Authorization"] = f"Bearer {____}"
try:
# Pass headers (and timeout) to the request; key never goes in the URL
r = requests.get(url, ____=____, timeout=10)
r.raise_for_status()
data = r.json()
rate = data["rates"].get(to_currency)
if rate is None:
return f"Could not find exchange rate for {from_currency} to {to_currency}"
return f"{amount} {from_currency} = {amount * rate:.2f} {to_currency} (Rate: {rate})"
except requests.exceptions.RequestException as e:
return f"Error converting currency: {e}"
print(convert_currency(10, "USD", "EUR"))