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

make docker-build

2. Add to Cursor

Create or edit ~/.cursor/mcp.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

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

---

Weather data from National Weather Service (US locations only)