<p align="center">
  <img src="logo.png" alt="Weather MCP Server" width="180" height="180"/>
</p>

<h1 align="center">🌦️ Weather MCP Server</h1>

<p align="center">
  <strong>Global weather intelligence for AI assistants via the Model Context Protocol</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"/></a>
  <a href="https://www.npmjs.com/package/@fazorboy/weather-mcp-server"><img src="https://img.shields.io/npm/v/@fazorboy/weather-mcp-server.svg" alt="npm version"/></a>
  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%3E%3D18-green.svg" alt="Node.js"/></a>
  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.x-blue.svg" alt="TypeScript"/></a>
  <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP-Model%20Context%20Protocol-purple.svg" alt="MCP"/></a>
</p>

<p align="center">
  An <a href="https://open-meteo.com/">Open-Meteo</a> powered MCP server providing <b>10 weather tools</b> — forecasts, historical data, air quality, marine, geocoding, elevation, and climate projections at 1km resolution with 80+ years of archive. <b>No API key required.</b>
</p>

---

## 📦 Packages

| Package | Description | README |
|---------|-------------|--------|
| [`@fazorboy/weather-mcp-server`](packages/weather-mcp-server/) | MCP server — standalone CLI, npm package | [📖 Server README](packages/weather-mcp-server/README.md) |
| [`weather-mcp-vscode-extension`](packages/weather-mcp-vscode-extension/) | VS Code extension — auto-registers the MCP server | [📖 Extension README](packages/weather-mcp-vscode-extension/README.md) |

---

## ⚡ Quick Start

### Option 1: VS Code Extension (recommended)

Install the **Weather MCP Server** extension from the VS Code Marketplace — the server starts automatically for Copilot and other AI assistants.

→ See [Extension README](packages/weather-mcp-vscode-extension/README.md) for details.

### Option 2: Standalone MCP Server

```bash
npx @fazorboy/weather-mcp-server
```

→ See [Server README](packages/weather-mcp-server/README.md) for Claude Desktop config, environment variables, and more.

---

## 🔧 10 Weather Tools

| # | Tool | Description |
|---|------|-------------|
| 1 | `weather_get_forecast` | Hourly/daily forecasts up to 16 days |
| 2 | `weather_get_current` | Real-time conditions |
| 3 | `weather_get_historical` | 80+ years of weather archive |
| 4 | `weather_get_air_quality` | PM2.5, PM10, ozone, NO₂, AQI |
| 5 | `weather_get_marine` | Wave height, period, direction |
| 6 | `weather_geocode_search` | Search locations by name |
| 7 | `weather_geocode_reverse` | Reverse geocode coordinates |
| 8 | `weather_get_elevation` | Elevation (90m DEM) |
| 9 | `weather_get_climate_projection` | Climate projections (CMIP6) |
| 10 | `weather_compare_locations` | Compare 2–5 locations |

---

## 📄 License

[MIT](LICENSE) © bhayanak