MCP Weather Server

🚀 US Weather MCP Server

This repository contains an MCP (Model Context Protocol) server for accessing US weather data from the National Weather Service (NWS) API. The server provides tools to obtain weather alerts and forecasts for any US state.

🚀 Quick Start

The server runs through standard input and output, making it compatible with MCP clients. To start the server, run the following command:

python weather.py

✨ Features

• Retrieve weather alerts for any US state using a two-letter state code.
• Obtain detailed weather forecasts by latitude and longitude.
• Structured logging with context information.
• Error handling and timeout management.

📦 Installation

Install via Smithery

To automatically install the mcp-weather-server to Claude Desktop using Smithery, run the following command:

npx -y @smithery/cli install @asifdotpy/mcp-weather-server --client claude

Manual Installation

# Clone the repository
git clone <repository-url>

# Navigate to the directory
cd weather

# Install dependencies (Python 3.11+ required)
pip install -e .

📚 Documentation

Dependencies

• httpx: For making asynchronous HTTP requests.
• mcp: A Model Context Protocol library for building MCP servers.

Usage

The server provides two main tools:

Get Weather Alerts

get_alerts(state: str) -> str

• state: A two-letter US state code (e.g., CA, NY).
• Returns formatted weather alert information for the specified state.

Get Weather Forecast

get_forecast(latitude: float, longitude: float) -> str

• latitude: The latitude of the location.
• longitude: The longitude of the location.
• Returns a 5-period weather forecast for the specified coordinates.

Development

• Set the ENV environment variable to "production" to get JSON-formatted logs.
• Use the LOG_LEVEL environment variable to configure the log level.

📄 License

[Specify your license information here]

🔗 Badge