# MCP Weather Server

A containerized **Model Context Protocol (MCP)** server that provides weather tools for AI assistants using the National Weather Service API.

## 🚀 Quick Start

### 1. Build Docker Image

```bash
make docker-build
```

### 2. Add to Cursor

Create or edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "mcp-weather-server:latest"],
      "env": {}
    }
  }
}
```

### 3. Restart Cursor

Close and reopen Cursor to load the weather server.

## 🌤️ Available Tools

- **get_alerts** - Weather alerts for any US state (e.g., `CA`, `NY`)
- **get_forecast** - Weather forecast for coordinates (latitude, longitude)

## 🧪 Test Usage

In Cursor chat:

```
"Get weather alerts for California"
"What's the weather forecast for coordinates 40.7128, -74.0060?"
```

## 📋 Requirements

- Docker Desktop running
- Cursor IDE

## 🔧 Commands

```bash
make docker-build     # Build image
make test-docker      # Test container
make help            # See all commands
```

---

**Weather data from National Weather Service (US locations only)**