WeatherMCP

# WeatherMCP This project is an **MCP server** built as a hands-on exercise. It provides weather data and alerts from the US National Weather Service (NWS) via a simple API using the [FastMCP](https://github.com/multiprocessio/fastmcp) framework. ## Features - **Weather Alerts**: Get active weather alerts for any US state. - **Forecast**: Retrieve weather forecasts for a specific latitude and longitude. ## Requirements - Python 3.8+ - [uv](https://github.com/astral-sh/uv) (for dependency management and running) ## Installation 1. **Install dependencies using uv:** ```sh uv pip install -r requirements.txt ``` Or, if you use `pyproject.toml`: ```sh uv pip install -r pyproject.toml ``` 2. **(Optional) Create a virtual environment:** ```sh uv venv .venv source .venv/bin/activate ``` ## Running the MCP Server To start the server using `uv`: ```sh uv pip install -e . # if you want to install as editable, or just ensure dependencies are installed uv python weather.py ``` The server will start and listen for MCP requests via stdio. ## Available Tools ### 1. `get_alerts(state: str)` - **Description:** Get active weather alerts for a US state. - **Argument:** `state` — Two-letter US state code (e.g., `CA`, `NY`). - **Returns:** Formatted string of current alerts or a message if none are found. ### 2. `get_forecast(latitude: float, longitude: float)` - **Description:** Get weather forecast for a specific location. - **Arguments:** - `latitude` — Latitude of the location (float) - `longitude` — Longitude of the location (float) - **Returns:** Formatted string with the next 5 forecast periods. ## Notes - This project is for educational and hands-on purposes. - Data is sourced from the [National Weather Service API](https://www.weather.gov/documentation/services-web-api). --- Feel free to extend or modify the project for your own experiments!