MCP Weather

What is MCP Weather?

MCP Weather is a Python application that serves as an MCP (Model Context Protocol) tool, allowing AI assistants to access real-time weather information from the National Weather Service (NWS) API. It provides two main functions: retrieving active weather alerts for any US state and obtaining detailed weather forecasts for any US location by latitude and longitude.

How to use MCP Weather?

Clone the repository, ensure Python 3.13+ and the uv package manager are installed, then run uv run weather.py. To integrate as an MCP tool, use the command PATH/uv --directory ABSOLUTE_PATH/mcp-weather run weather.py. The server exposes two tools: Get Weather Alerts (parameter: state – two-letter US state code) and Get Weather Forecast (parameters: latitude, longitude).

Key features of MCP Weather

• Retrieve active weather alerts by US state code
• Get detailed weather forecasts for specific latitude/longitude
• Clean, formatted output for easy reading
• Built as an MCP tool for seamless AI assistant integration

Use cases of MCP Weather

• AI assistant answering “What weather alerts are active in California?”
• AI assistant providing a detailed forecast for a user’s current GPS location
• Developers embedding live NWS weather data into MCP-compatible applications

FAQ from MCP Weather

What data source does MCP Weather use?

The application uses the National Weather Service API to fetch weather data.

What are the runtime requirements for MCP Weather?

Python 3.13 or higher, the uv package manager, and dependencies httpx and mcp[cli].

How do I start the MCP Weather server for testing?

Run uv run weather.py from the project directory.

What parameters does the “Get Weather Alerts” tool require?

It requires a two-letter US state code, for example CA or NY.

What parameters does the “Get Weather Forecast” tool require?

It requires a latitude and longitude (decimal) for the location.