Overview
What is Weather MCP Server?
Weather MCP Server is a Model Context Protocol server that provides US weather forecasts and alerts through Claude for Desktop. It integrates with the National Weather Service (NWS) API to return detailed forecasts for any latitude/longitude and active alerts for any US state code.
How to use Weather MCP Server?
Install the server using the uv package manager, configure it in Claude for Desktop’s configuration file (claude_desktop_config.json) by specifying the uv command and the absolute path to the project directory. After restarting Claude, look for the hammer 🔨 icon and ask queries like “What’s the weather in Sacramento?” or “What are the active weather alerts in Texas?”
Key features of Weather MCP Server
get_forecast: Get detailed forecasts using latitude and longitude.get_alerts: Retrieve active weather alerts for a US state.- Relies entirely on the public National Weather Service API.
- Designed for use with Claude for Desktop.
- Created as part of the MIT MCP Hackathon tutorial.
Use cases of Weather MCP Server
- Ask Claude for the current weather forecast for any US location.
- Ask Claude for active weather warnings or watches in a given state.
- Integrate real‑time NWS data into conversational AI workflows.
FAQ from Weather MCP Server
What are the runtime requirements?
Python 3.10 or higher, the uv package manager, Claude for Desktop, and the MCP SDK 1.2.0 or higher. The httpx library is also required.
How do I configure the server in Claude for Desktop?
Edit the file ~/Library/Application Support/Claude/claude_desktop_config.json and add a weather entry under mcpServers with the path to uv and the project directory as shown in the README.
Where can I find logs if something goes wrong?
Claude’s logs are stored at ~/Library/Logs/Claude/mcp*.log. Ensure all paths in the configuration are absolute and that port 8001 is not in use.
Which API does the server use?
It uses the U.S. National Weather Service API (api.weather.gov) to fetch forecast grid data and active alerts. No API key is required.
Can I run the server independently of Claude?
Yes, you can verify it by running uv run weather.py from the project directory.
