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