# weather-history-mcp

Servidor MCP que expone clima histórico por hora (temperatura, humedad, sensación
térmica, nubosidad) usando la API gratuita de [Open-Meteo](https://open-meteo.com/),
sin necesidad de API key.

Piensa en esto como un "adaptador": traduce preguntas de Claude ("¿qué clima hacía
el 9 de agosto de 2026 a las 8am en Víctor Larco, Trujillo?") en llamadas a la API
de Open-Meteo, y devuelve la respuesta en un formato que Claude puede leer.

## Herramientas que expone

- **get_historical_weather**: clima hora por hora (24 horas) para una fecha y
  coordenadas dadas.
- **get_weather_at_time**: clima en una hora específica de un día pasado (más
  directo cuando solo te interesa un momento puntual, como la hora de inicio de
  un entrenamiento).

## Correrlo en tu computadora (para probar)

```bash
npm install
npm start
```

El servidor queda escuchando en `http://localhost:3000`, con el endpoint MCP en
`http://localhost:3000/mcp`.

## Desplegarlo en Railway (para que funcione 24/7 desde cualquier dispositivo)

1. Crea una cuenta gratuita en [railway.app](https://railway.app) (puedes entrar
   con tu cuenta de GitHub).
2. Sube este proyecto a un repositorio de GitHub (instrucciones abajo).
3. En Railway: **New Project → Deploy from GitHub repo** → selecciona este repo.
4. Railway detecta automáticamente que es un proyecto Node.js (por el
   `package.json`) y lo despliega solo. No hace falta configurar nada más.
5. Cuando termine el despliegue, Railway te da una URL pública, algo como
   `https://weather-history-mcp-production.up.railway.app`.
6. Tu endpoint MCP para conectar a Claude será esa URL + `/mcp`, por ejemplo:
   `https://weather-history-mcp-production.up.railway.app/mcp`

## Conectarlo a Claude

1. Ve a la configuración de conectores de Claude (claude.ai → Settings → Connectors,
   o el equivalente en la app).
2. Agrega un connector personalizado ("Add custom connector" o similar).
3. Pega la URL de Railway terminada en `/mcp`.
4. Guarda. A partir de ahí, en cualquier chat puedes activarlo y Claude podrá
   consultar clima histórico directamente.

## Subir este proyecto a GitHub (si no lo has hecho)

```bash
git init
git add .
git commit -m "Servidor MCP de clima histórico"
git branch -M main
git remote add origin https://github.com/TU_USUARIO/weather-history-mcp.git
git push -u origin main
```

(Créalo primero vacío en github.com/new, sin README ni licencia, para que el push
no choque con archivos ya existentes).