README.md•1.15 kB
# 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)**