# Weather MCP Server

An MCP (Model Context Protocol) server that gives Claude real-time weather 
data from the US National Weather Service API — no API key needed.

## What it does

- `get_alerts` — fetches active weather alerts for any US state
- `get_forecast` — fetches a 5-period forecast for any lat/long location

## Requirements

- Python 3.12+
- uv

## Setup

Clone the repo and install dependencies:

    git clone https://github.com/YOUR_USERNAME/weather-mcp-server
    cd weather-mcp-server
    uv venv --python 3.12
    source .venv/bin/activate
    uv add "mcp[cli]" httpx

## Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

    {
      "mcpServers": {
        "weather": {
          "command": "uv",
          "args": ["--directory", "/path/to/weather-mcp-server", "run", "weather.py"]
        }
      }
    }

Restart Claude Desktop. Look for the hammer icon in the chat input.

## Built with

- MCP Python SDK (https://github.com/modelcontextprotocol/python-sdk)
- National Weather Service API (https://api.weather.gov)