Weather MCP Server

What is Weather MCP Server?

Weather MCP Server is a Model Context Protocol (MCP) server that provides weather information and alerts using the National Weather Service (NWS) API. It is built for developers who need to access real-time weather data through an MCP-compatible interface.

How to use Weather MCP Server?

Install Python 3.13+ and uv, then clone the repo, install dependencies with uv pip install . and run with uv run src/main.py. Alternatively, deploy with Docker using docker compose up -d; the server is then available at http://localhost:8001/sse. Two tools are provided: get_alerts(state) for US state alerts and get_forecast(latitude, longitude) for location forecasts.

Key features of Weather MCP Server

• Get weather alerts for any US state
• Get detailed weather forecasts using latitude/longitude
• Easy-to-use MCP interface
• Docker support for easy deployment
• Built with Python’s MCP framework and httpx
• Implements proper error handling and request timeouts

Use cases of Weather MCP Server

• Retrieve active weather alerts for a specific US state
• Obtain a detailed forecast for any location given its coordinates
• Deploy the server containerized with Docker Compose
• Integrate NWS weather data into MCP‑enabled applications

FAQ from Weather MCP Server

What data source does Weather MCP Server use?

It uses the National Weather Service (NWS) API.

What are the prerequisites to run it?

Python 3.13 or higher is required for local development; Docker and Docker Compose are needed for containerized deployment.

What tools are available?

get_alerts(state) returns active alerts for a two‑letter US state code, and get_forecast(latitude, longitude) returns a detailed forecast for the given coordinates.

How do I deploy with Docker?

Run docker compose up -d in the project root. The server will be accessible at http://localhost:8001/sse.

Which port does the server use?

Inside the container the server runs on port 8000, which is mapped to port 8001 on the host machine.