what is MCP-Weather-Server?
MCP-Weather-Server is a server that provides access to US weather data from the National Weather Service (NWS) API, allowing users to fetch weather alerts and forecasts for various locations across the United States.
how to use MCP-Weather-Server?
To use the server, clone the repository, install the required dependencies, and run the server. You can then use the provided functions to get weather alerts and forecasts by state or geographical coordinates.
key features of MCP-Weather-Server?
- Fetch weather alerts for any US state using two-letter state codes.
- Retrieve detailed weather forecasts based on latitude and longitude.
- Structured logging with contextual information for better debugging.
- Error handling and timeout management for robust performance.
use cases of MCP-Weather-Server?
- Monitoring weather conditions and alerts for specific states.
- Integrating weather data into applications for real-time updates.
- Providing weather forecasts for planning events or travel.
FAQ from MCP-Weather-Server?
- What programming language is used for MCP-Weather-Server?
The server is built using Python.
- How can I run the server?
You can run the server by executing
python weather.pyafter setting up the environment.
- Is there any license for this project?
The license details should be specified in the repository.
Weather MCP Server
Overview
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 fetch weather alerts and forecasts for locations across the United States.
Features
- Get weather alerts for any US state using two-letter state codes
- Retrieve detailed weather forecasts by latitude and longitude
- Structured logging with contextual information
- Error handling and timeout management
Installation
# Clone the repository
git clone <repository-url>
# Navigate to the directory
cd weather
# Install dependencies (requires Python 3.11+)
pip install -e .
Dependencies
- httpx: For making asynchronous HTTP requests
- mcp: Model Context Protocol library for building MCP servers
Usage
The server provides two main tools:
Get Weather Alerts
get_alerts(state: str) -> str
state: Two-letter US state code (e.g., CA, NY)- Returns formatted weather alerts for the specified state
Get Weather Forecast
get_forecast(latitude: float, longitude: float) -> str
latitude: Latitude of the locationlongitude: Longitude of the location- Returns a 5-period weather forecast for the specified coordinates
Running the Server
python weather.py
The server runs over stdio, making it compatible with MCP clients.
Development
- Set the
ENVenvironment variable to "production" for JSON-formatted logs - Configure logging level with the
LOG_LEVELenvironment variable
License
[Specify your license here]
