Guía Práctica: Creando tu Primer Servidor MCP en Python

¡Hola! Si quieres aprender en la práctica cómo conectar aplicaciones de IA con el mundo real, esta guía es para ti. Construiremos, paso a paso, un servidor para el Model Context Protocol (MCP) usando Python.

La idea es mostrar, de forma práctica, cómo exponer funcionalidades de tu código para que cualquier aplicación compatible con MCP, como un LLM, pueda utilizarlas.

¿Qué vamos a construir?

Nuestro objetivo es crear un servidor de previsión del tiempo que ofrezca cuatro herramientas simples pero potentes:

get_current_weather_city: Obtener el clima actual en una ciudad brasileña.
get_forecast_city: Obtener la previsión para los próximos días.
get_weather_coordinates: Para mayor precisión, consultar por latitud y longitud.
get_weather_state_capital: Consultar el clima en la capital de un estado brasileño.

Al final, tendrás un servidor funcional que podrás conectar a un host como Claude for Desktop, permitiendo consultas en tiempo real.

Antes de comenzar: lo que necesitas

Python 3.10 o superior instalado
Familiaridad básica con LLMs
Una cuenta gratuita en OpenWeatherMap para obtener una API key
Claude for Desktop u otro host compatible con MCP

Preparando el entorno

Instala uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Crea la carpeta del proyecto
```
uv init weather
cd weather
```
Crea y activa el entorno virtual
```
uv venv
source .venv/bin/activate
```
Instala dependencias
```
uv add "mcp[cli]" httpx python-dotenv
```

Crea los archivos del proyecto

touch weather.py
echo "OPENWEATHER_API_KEY=TU_CLAVE_AQUI" > .env

Construyendo el servidor

Añade el código en weather.py por etapas (importaciones, función de petición asíncrona, formateo de datos, herramientas con @mcp.tool(), y bloque principal para ejecutar el servidor). Mantén lang="pt_br" en las llamadas a la API si quieres descripciones en portugués; ajusta según necesidad.

Conectando con Claude for Desktop

Edita el archivo de configuración de Claude para apuntar a tu servidor local y reinicia la aplicación.

Probando

Con Claude abierto, ve a “Search and tools” y prueba preguntas como:

“¿Cómo está el clima en Salvador, Bahía?”
“¿Cuál es el pronóstico para Curitiba?”

Continúa tu camino con MCP

¡Espero que esta guía te haya ayudado a desmitificar la creación de servidores MCP!