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, 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)

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 (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)

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).