Weather MCP Server

@sirrupesh

About Weather MCP Server

No overview available yet

#weather-mcp #weather-server #weather-alerts

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "weather-mcp-server-sirrupesh": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.