wu-weather-mcp

Un servidor MCP que expone cualquier estación meteorológica personal (PWS) de Weather Underground como herramientas en Claude. Pregúntale a Claude sobre las condiciones actuales, resúmenes diarios, historial horario y metadatos de la estación, todo obtenido en tiempo real desde tu estación.

Requisitos previos

• Node.js 18+

• Una cuenta de Weather Underground con una PWS

• Una clave de API de Weather Underground (gratuita)

• Tu ID de estación (visible en tu panel de control de WU, p. ej., KCALAKEF92)

Related MCP server: weather-mcp-server

Configuración

1. Clonar e instalar

git clone https://github.com/your-username/wu-weather-mcp.git
cd wu-weather-mcp
npm install

2. Configurar el entorno

cp .env.example .env

Edita .env:

WU_API_KEY=your_api_key_here
WU_STATION_ID=your_station_id_here
WU_STATION_NAME=My Weather Station   # optional — defaults to station ID

3. Compilar

npm run build

4. Probar

node build/index.js

El servidor se inicia en stdio y espera mensajes MCP. Presiona Ctrl-C para salir.

Integración con Claude Desktop

Añade esto a tu claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wu-weather": {
      "command": "node",
      "args": ["/absolute/path/to/wu-weather-mcp/build/index.js"]
    }
  }
}

Reemplaza /absolute/path/to/wu-weather-mcp con la ruta real donde clonaste el repositorio. En macOS puedes ejecutar pwd dentro de la carpeta clonada para obtenerla.

Reinicia Claude Desktop después de guardar. Tus herramientas meteorológicas aparecerán automáticamente.

Alternativa: pasar credenciales mediante configuración en lugar de .env

{
  "mcpServers": {
    "wu-weather": {
      "command": "node",
      "args": ["/absolute/path/to/wu-weather-mcp/build/index.js"],
      "env": {
        "WU_API_KEY": "your_api_key_here",
        "WU_STATION_ID": "your_station_id_here",
        "WU_STATION_NAME": "My Weather Station"
      }
    }
  }
}

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tiempo hace ahora mismo?"

• "Muéstrame los últimos 3 días de clima."

• "¿Cuál fue el desglose horario de ayer por la tarde?"

• "¿Cuál es la elevación de mi estación meteorológica?"

Desarrollo

npm run dev      # watch mode — recompiles on save
npm run build    # one-off build

El código fuente está en src/index.ts. Recompila (npm run build) después de cualquier cambio.

Publicar en npm

npm publish

Una vez publicado, los usuarios pueden ejecutarlo sin clonar:

{
  "mcpServers": {
    "wu-weather": {
      "command": "npx",
      "args": ["-y", "wu-weather-mcp"],
      "env": {
        "WU_API_KEY": "your_api_key_here",
        "WU_STATION_ID": "your_station_id_here"
      }
    }
  }
}

Nota: Verifica primero en npmjs.com para confirmar que el nombre del paquete wu-weather-mcp esté disponible antes de publicar.

Licencia

MIT