# Weather MCP

An MCP server that provides current weather, 7-day forecasts, and US weather alerts — no API keys required.

## APIs Used

| Purpose | API |
|---------|-----|
| Current weather & forecast | `api.open-meteo.com` |
| City name to coordinates | `geocoding-api.open-meteo.com` |
| US weather alerts | `api.weather.gov` (National Weather Service) |

## Tools

### `get_current_weather`
Get current weather conditions for any city in the world.

**Example:** *"What's the weather in Tokyo?"*

### `get_forecast`
Get a 7-day weather forecast for any city in the world.

**Example:** *"What's the forecast for London this week?"*

### `get_alerts`
Get active weather alerts for a US state. US only.

**Example:** *"Any weather alerts in California?"*

## Setup

### 1. Install dependencies
```bash
npm install
```

### 2. Build
```bash
npm run build
```

### 3. Add to Claude Desktop
Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/MCP/weather/build/index.js"]
    }
  }
}
```

Then restart Claude Desktop.

## Project Structure

```
├── src/
│   ├── index.ts        # MCP server and tool definitions
│   └── constants.ts    # API endpoint constants
├── build/              # Compiled output (generated)
├── package.json
└── tsconfig.json
```