Herramienta Mcp del Clima para Claude Desktop

¿Qué es Weather-MCP-ClaudeDesktop?

Weather-MCP-ClaudeDesktop es una herramienta poderosa diseñada para proporcionar datos meteorológicos en tiempo real, pronósticos e información histórica sobre el clima. Utilizando la API de OpenWeatherMap, esta aplicación está específicamente adaptada para usuarios de Claude Desktop, asegurando una experiencia fluida para aquellos que buscan actualizaciones meteorológicas precisas y oportunas.

Características de Weather-MCP-ClaudeDesktop

Datos Meteorológicos en Tiempo Real: Accede a las condiciones climáticas actuales para cualquier ubicación en todo el mundo.
Pronósticos: Obtén pronósticos meteorológicos detallados para los próximos días, ayudando a los usuarios a planificar sus actividades en consecuencia.
Información Meteorológica Histórica: Recupera datos climáticos pasados para analizar tendencias y patrones a lo largo del tiempo.
Interfaz Amigable: Diseñada con un enfoque en la usabilidad, facilitando a los usuarios la navegación y la búsqueda de la información que necesitan.
Integración con la API de OpenWeatherMap: Aprovecha las robustas capacidades de la API de OpenWeatherMap para una fuente de datos confiable.

Cómo Usar Weather-MCP-ClaudeDesktop

Instalación: Descarga e instala la aplicación Weather-MCP-ClaudeDesktop desde el repositorio oficial.
Configuración de la Clave API: Obtén una clave API de OpenWeatherMap e introdúcela en la configuración de la aplicación para habilitar la recuperación de datos.
Seleccionar Ubicación: Ingresa la ubicación deseada para la cual quieres ver los datos meteorológicos.
Ver Datos: Accede a actualizaciones meteorológicas en tiempo real, pronósticos y datos históricos a través de la interfaz intuitiva.
Personalizar Configuraciones: Ajusta las configuraciones para adaptar la aplicación a tus preferencias, como unidades de medida y configuraciones de notificación.

Preguntas Frecuentes

¿Qué plataformas soporta Weather-MCP-ClaudeDesktop?

Weather-MCP-ClaudeDesktop está diseñado para Claude Desktop, asegurando compatibilidad con su sistema operativo.

¿Hay algún costo asociado con el uso de Weather-MCP-ClaudeDesktop?

La aplicación es gratuita, pero los usuarios deben registrarse para obtener una clave API de OpenWeatherMap, que puede tener límites de uso según el plan elegido.

¿Puedo contribuir al desarrollo de Weather-MCP-ClaudeDesktop?

¡Sí! Se aceptan contribuciones. Puedes bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción para revisión.

¿Con qué frecuencia se actualizan los datos meteorológicos?

Los datos meteorológicos se actualizan en tiempo real, dependiendo de la frecuencia establecida por la API de OpenWeatherMap, típicamente cada pocos minutos.

¿Qué debo hacer si encuentro problemas con la aplicación?

Si experimentas algún problema, consulta el rastreador de problemas del repositorio para soluciones o informa un nuevo problema para obtener asistencia.

Weather MCP Tool for Claude Desktop

An MCP (Model Context Protocol) tool that provides real-time weather data, forecasts, and historical weather information using the OpenWeatherMap API, specifically designed for Claude Desktop.

Tutorial

For a detailed guide on setting up and using this tool, check out our comprehensive Medium tutorial: Tutorial: Using Claude Desktop with Weather MCP Tool to Access Real-Time Weather Data Worldwide

Features

Real-time weather conditions for any location
Weather forecasts (up to 5 days)
Historical weather data (last 5 days)
Air quality information
Weather alerts and warnings
Location search functionality

Setup

Ensure you have Python 3.10 or higher installed
Install dependencies:

pip install -r requirements.txt

Get an API key from OpenWeatherMap (free tier available)
- Note: New API keys may take up to 24 hours to activate
Set up environment variables for API key (recommended method):
- Create a .env file in the project directory
- Add your API key to the file:
```
OPENWEATHER_API_KEY=your_openweathermap_api_key
```
- Add .env to your .gitignore file to prevent committing sensitive data

Update main.py to use the environment variable:

# Add these imports at the top
import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()

# Replace the API_KEY line with
API_KEY = os.getenv("OPENWEATHER_API_KEY")

Integration with Claude Desktop

Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:

{
  "mcpServers": {
    "weather-mcp": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Weather-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

Replace the path with the full path to your main.py file
Run the server using:

py -3.13 main.py

Keep the server running while using Claude Desktop

Available Tools

1. get_current_weather

Get real-time weather conditions for a location:

{
    "location": {
        "name": "New York",
        "country": "US",
        "lat": 40.7128,
        "lon": -74.006
    },
    "temperature": {
        "current": 25.6,
        "feels_like": 26.2,
        "min": 23.4,
        "max": 27.8
    },
    "weather_condition": {
        "main": "Clear",
        "description": "clear sky",
        "icon": "01d"
    },
    "wind": {
        "speed": 3.6,
        "deg": 220
    },
    "clouds": 5,
    "humidity": 65,
    "pressure": 1015,
    "visibility": 10000,
    "sunrise": "2025-03-16T06:12:34",
    "sunset": "2025-03-16T18:04:23",
    "timestamp": "2025-03-16T14:30:00"
}

2. get_weather_forecast

Get weather forecast for a location:

{
    "location": {
        "name": "London",
        "country": "GB",
        "lat": 51.5074,
        "lon": -0.1278
    },
    "forecast": [
        {
            "datetime": "2025-03-16T15:00:00",
            "temperature": {
                "temp": 18.2,
                "feels_like": 17.8,
                "min": 17.5,
                "max": 19.1
            },
            "weather_condition": {
                "main": "Rain",
                "description": "light rain",
                "icon": "10d"
            },
            "wind": {
                "speed": 4.2,
                "deg": 180
            },
            "clouds": 75,
            "humidity": 82,
            "pressure": 1010,
            "visibility": 8000,
            "pop": 0.4
        }
        // ... more forecast items
    ],
    "days": 5
}

3. get_air_quality

Get air quality data for a location:

{
    "location": {
        "name": "Beijing",
        "country": "CN",
        "lat": 39.9042,
        "lon": 116.4074
    },
    "air_quality_index": 3,
    "air_quality_level": "Moderate",
    "components": {
        "co": 250.34,
        "no": 0.5,
        "no2": 15.2,
        "o3": 140.8,
        "so2": 5.1,
        "pm2_5": 8.2,
        "pm10": 12.3,
        "nh3": 0.7
    },
    "timestamp": "2025-03-16T14:30:00"
}

4. get_historical_weather

Get historical weather data for a specific date:

{
    "location": {
        "name": "Paris",
        "country": "FR",
        "lat": 48.8566,
        "lon": 2.3522
    },
    "date": "2025-03-14",
    "temperature": {
        "temp": 20.3,
        "feels_like": 19.8
    },
    "weather_condition": {
        "main": "Clouds",
        "description": "scattered clouds",
        "icon": "03d"
    },
    "wind": {
        "speed": 2.8,
        "deg": 150
    },
    "clouds": 45,
    "humidity": 60,
    "pressure": 1012,
    "visibility": 10000,
    "sunrise": "2025-03-14T06:30:45",
    "sunset": "2025-03-14T18:15:22",
    "timestamp": "2025-03-14T12:00:00"
}

5. search_location

Search for locations by name:

{
    "results": [
        {
            "name": "Tokyo",
            "state": "",
            "country": "JP",
            "lat": 35.6762,
            "lon": 139.6503
        },
        {
            "name": "Tokyo",
            "state": "Tokyo",
            "country": "JP",
            "lat": 35.6895,
            "lon": 139.6917
        }
        // ... more results
    ]
}

6. get_weather_alerts

Get weather alerts for a location:

{
    "location": {
        "name": "Miami",
        "country": "US",
        "lat": 25.7617,
        "lon": -80.1918
    },
    "alerts": [
        {
            "sender": "NWS Miami",
            "event": "Heat Advisory",
            "start": "2025-03-16T12:00:00",
            "end": "2025-03-16T20:00:00",
            "description": "Heat index values between 105 and 110 expected",
            "tags": ["Extreme temperature value"]
        }
        // ... more alerts if any
    ],
    "alert_count": 1
}

Sample Queries

You can ask Claude Desktop questions like:

"What's the current weather in New York?"
"Show me the 5-day forecast for London"
"What's the air quality like in Beijing today?"
"How was the weather in Paris on March 14th?"
"Search for locations named 'Tokyo'"
"Are there any weather alerts for Miami?"
"Compare the current weather in Chicago, Miami, and Seattle"
"Show me a comparison of air quality in Beijing, Los Angeles, and Delhi"

Error Handling

All tools include proper error handling and will return an error message if something goes wrong:

{
    "error": "Failed to fetch current weather for InvalidLocation: Location not found"
}

Troubleshooting

If the MCP server is not working in Claude Desktop:

Make sure the server is running - you should see output when you start the script
Verify the path in your settings is correct and absolute
Make sure Python 3.10+ is in your system PATH
Check that all dependencies are installed
Try restarting Claude Desktop
Check logs for any error messages

Common API Issues

API Key Activation: New OpenWeatherMap API keys may take up to 24 hours to activate
Invalid API Key Error: If you get a 401 error, verify your API key is correct and active
Rate Limiting: Free tier allows up to 60 calls per minute, which might be exceeded during heavy usage

Rate Limits

This tool uses the OpenWeatherMap API which has rate limits. The free tier allows up to 60 calls per minute, which should be sufficient for personal use. Please be aware that very frequent requests may be throttled by the API.

License

MIT License