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