Content
# mcp-python
A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that exposes US weather data — via the [National Weather Service API](https://www.weather.gov/documentation/services-web-api) — as tools, resources, and prompts for MCP-compatible clients like Claude Desktop.
## Features
**Tools**
- `get_alerts(state)` — active weather alerts for a two-letter US state code (e.g. `CA`, `NY`)
- `get_forecast(latitude, longitude)` — forecast for the next 5 periods at a given location
**Resources**
- `weather://states` — list of valid two-letter US state codes
- `weather://alerts/{state}` — alerts for any state, as a readable resource
- Static alert resources for `CA`, `NY`, `TX`, `FL` (so they're attachable from Claude Desktop's picker, which only lists static resources)
**Prompts**
- `weather_briefing(state)` — concise severe weather briefing for a state
- `trip_packing_advice(latitude, longitude)` — packing advice based on the forecast for a location
## Requirements
- Python >= 3.11
- [uv](https://docs.astral.sh/uv/)
## Setup
```bash
uv sync
```
## Running the server
```bash
uv run weather.py
```
The server communicates over stdio, so it's meant to be launched by an MCP client rather than run standalone.
## Using with Claude Desktop
Add to your Claude Desktop config (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"weather": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/mcp-python",
"run",
"weather.py"
]
}
}
}
```
Restart Claude Desktop and the weather tools, resources, and prompts will be available.
## Project structure
- `weather.py` — the MCP server (tools, resources, prompts)
- `main.py` — placeholder entrypoint from the project template
- `pyproject.toml` / `uv.lock` — dependencies, managed with `uv`
