weather-mcp

Un servidor MCP (Model Context Protocol) que permite que un asistente de IA (Claude, Gemini CLI o cualquier cliente compatible con MCP) responda a preguntas meteorológicas reales con datos en vivo, en lugar de solo obtener datos en bruto.

Desarrollado con Open-Meteo — gratis, sin necesidad de clave de API.

Por qué esto no es solo un envoltorio de una API meteorológica

La mayoría de las integraciones meteorológicas simplemente devuelven temperature: 22°C. Este añade una capa de razonamiento, así puedes preguntar cosas que una API simple no puede responder directamente:

• get_weather("Bangalore") — condiciones actuales + pronóstico de hoy

• should_i_carry_umbrella("Mumbai") — una respuesta de sí/no con razonamiento, no solo un porcentaje de lluvia

• is_good_for_outdoors("Delhi") — analiza lluvia, viento y temperatura en conjunto para decidir si es un buen día para estar al aire libre

• compare_weather("Bangalore", "Delhi") — compara dos ciudades a la vez

Related MCP server: Weather MCP Server

Configuración

git clone https://github.com/darshan0548/weather-mcp.git
cd weather-mcp
python3 -m venv venv
source venv/bin/activate   # on Windows: venv\Scripts\activate
pip install -r requirements.txt

Ejecutar las pruebas

Una comprobación rápida contra la API real (sin simulaciones, sin necesidad de clave de API):

python test_weather.py

Conectarlo a Claude Desktop

Añade esto a la configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/absolute/path/to/weather-mcp/server.py"]
    }
  }
}

Conectarlo a Gemini CLI

Añade esto a ~/.gemini/settings.json:

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/absolute/path/to/weather-mcp/server.py"]
    }
  }
}

Reinicia el cliente y luego pregúntele algo como "¿debería llevar un paraguas en Chennai hoy?"

Estructura del proyecto

weather_core.py     # talks to the Open-Meteo API, no MCP-specific code
weather_advice.py    # reasoning layer built on top of raw weather data
server.py            # MCP server — wires the above into tools
test_weather.py       # sanity tests against the real API

Mantenidos como archivos separados a propósito — weather_core.py y weather_advice.py no tienen dependencia alguna de MCP, por lo que son fáciles de probar o reutilizar por su cuenta.

Contribuir

Las PR son bienvenidas. Algunas ideas si quieres añadir una herramienta:

• Desglose por horas del pronóstico en lugar de solo el resumen de hoy

• Datos de calidad del aire (Open-Meteo tiene un endpoint gratuito para esto también)

• Planificación de viajes de varios días (mejor día semanal para un evento al aire libre)

• Alertas meteorológicas fuertes

Mantén las nuevas herramientas en weather_advice.py si añaden razonamiento sobre los datos en bruto, o en weather_core.py si son solo obtención de datos — luego conéctalas en server.py como un nuevo @mcp.tool().

Licencia

MIT — ver LICENSE.