Weather MCP Server
@oyzh888
This is a tutorial repo about MCP server and client
Overview
What is Weather MCP Server?
It is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API. It is intended for developers who want to integrate US weather alerts and forecasts into MCP-compatible applications.
How to use Weather MCP Server?
Install with Python 3.12+ and uv, then run uv run weather-server. The server exposes two tools: get_alerts(state) for US state weather alerts and get_forecast(latitude, longitude) for location-specific forecasts. To use with Claude for Desktop, add a configuration entry to claude_desktop_config.json pointing to the server directory.
Key features of Weather MCP Server
- Get weather alerts for US states
- Get detailed weather forecasts for specific locations
Use cases of Weather MCP Server
- Build a personal assistant that warns of severe weather in a chosen US state
- Create a travel planning tool that checks forecast conditions for a destination
- Integrate weather data into a decision-support system for outdoor events
- Power a dashboard that monitors alerts across multiple states
FAQ from Weather MCP Server
What data source does it use?
It uses the National Weather Service (NWS) API, which is free and public but only covers locations within the United States.
What are the runtime requirements?
Python 3.12 or higher and the uv package manager are required. Dependencies are installed via uv pip install -e ..
How do I configure it with Claude for Desktop?
Add a JSON block to ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers, specifying the uv command and the server directory path, then restart Claude for Desktop.
Does it require authentication?
No authentication or API key is needed; the NWS API is publicly accessible.
What are the known limitations?
Weather data is only available for US locations because the server relies on the National Weather Service API.