# Weather MCP Server
An MCP (Model Context Protocol) server that provides weather information tools using the National Weather Service (NWS) API.
## Features
This MCP server exposes two tools for accessing weather data:
- **`get_alerts`**: Get active weather alerts for any US state
- **`get_forecast`**: Get detailed weather forecast for a specific location (latitude/longitude)
## Requirements
- Python >= 3.14
- uv (recommended for dependency management)
## Setup
1. Clone this repository or download the source code
2. Install dependencies using uv:
```bash
uv sync
```
## Running the Server
The server runs using stdio transport for MCP communication:
```bash
uv run weather.py
```
## Using with MCP Clients
To use this server with an MCP client (like Claude Desktop), add it to your MCP client configuration:
```json
{
"mcpServers": {
"weather": {
"command": "uv",
"args": [
"--directory",
"c:\\Users\\Zachary\\Dev\\weather",
"run",
"weather.py"
]
}
}
}
```
## Available Tools
### get_alerts
Get active weather alerts for a US state.
**Parameters:**
- `state` (string): Two-letter US state code (e.g., "CA", "NY", "TX")
**Example:**
```
get_alerts(state="CA")
```
### get_forecast
Get weather forecast for a specific location.
**Parameters:**
- `latitude` (float): Latitude of the location
- `longitude` (float): Longitude of the location
**Example:**
```
get_forecast(latitude=37.7749, longitude=-122.4194)
```
## Data Source
This server uses the [National Weather Service API](https://www.weather.gov/documentation/services-web-api), which provides free weather data for US locations.
## License
Add your license information here.
