Weathernode

A production-ready weather service providing live weather data via REST API and MCP (Model Context Protocol) endpoints.

Features

Dual Protocol Support: REST API and MCP endpoints
Weather Data: Current weather and forecasts using WeatherAPI.com
Production Ready: Docker, Kubernetes, Helm charts
Security: Rate limiting, input validation, CORS
Monitoring: Health checks and metrics
TypeScript: Full type safety and modern development

Quick Start

Prerequisites

Node.js 18+
WeatherAPI.com API key (free tier: 1M calls/month)

Installation

# Clone repository git clone https://github.com/Philip-Walsh/weathernode.git cd weathernode # Install dependencies npm install # Set up environment cp .env.example .env # Add your WeatherAPI.com key to .env # Start development server npm run dev

Server runs on: http://localhost:3000

API Endpoints

REST API

# Current weather GET /api/weather?city=London # Weather forecast GET /api/forecast?city=London&days=5 # Default location weather GET /api/local # Health check GET /api/health

MCP Protocol

# List available tools POST /mcp { "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} } # Get weather data POST /mcp { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "get_weather", "arguments": {"city": "London"} } }

Development

npm run dev # Development server with hot reload npm run build # Build for production npm run start # Start production server npm test # Run test suite npm run lint # Lint code

Deployment

Docker

# Build image docker build -t weathernode . # Run container docker run -p 3000:3000 \ -e WEATHER_API_KEY=your_key_here \ weathernode

Kubernetes

# Create secret kubectl create secret generic weather-api-key \ --from-literal=api-key=your_weatherapi_key_here # Deploy with Helm helm install weather-service ./helm/weather-service \ --set env.WEATHER_API_KEY=your_key_here

Documentation

API Reference - Complete API documentation
Deployment Guide - Production deployment
WeatherAPI Setup - Weather data source setup

Environment Variables

WEATHER_API_KEY=your_weatherapi_key_here # Required DEFAULT_LOCATION=London # Optional TEMP_UNIT=C # Optional PORT=3000 # Optional NODE_ENV=development # Optional

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides live weather data and forecasts for any location worldwide through both REST API and MCP endpoints. Supports current weather, multi-day forecasts, and various location formats including city names, coordinates, ZIP codes, and airport codes.

Weather MCP Service