git clone <repo-url>
cd weather-mcp-server
npm install
npm run build

npm start

TRANSPORT=http npm start
# Server runs on http://localhost:3000/mcp
# Health check: http://localhost:3000/health

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

{
  "location": "Paris",
  "temperature_unit": "celsius",
  "wind_speed_unit": "kmh"
}

{
  "location": "New York",
  "days": 7,
  "include_hourly": false,
  "temperature_unit": "fahrenheit"
}

{
  "location": "Sydney",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
}

{
  "location": "Delhi"
}

{
  "location": "Miami",
  "days": 3
}

{
  "query": "Springfield",
  "count": 5
}

weather-mcp-server/
├── src/
│   ├── index.ts              # Server entry point & transport setup
│   ├── constants.ts          # WMO codes, API URLs, limits
│   ├── types.ts              # TypeScript interfaces
│   ├── schemas/
│   │   └── index.ts          # Zod validation schemas
│   ├── services/
│   │   └── weatherApi.ts     # API client & shared utilities
│   └── tools/
│       ├── currentWeather.ts
│       ├── forecast.ts
│       ├── historical.ts
│       ├── airQuality.ts
│       ├── marine.ts
│       └── geocoding.ts
└── dist/                     # Compiled output (run `npm run build`)