Overview
What is Weather MCP Server?
The Weather MCP Server is a Model Context Protocol server that allows AI assistants like Claude to retrieve real-time weather alerts and forecasts from the National Weather Service (NWS) API for a given location in the United States.
How to use Weather MCP Server?
Clone the repository, install dependencies (Python 3.11.6+, uv, httpx, fastmcp), add the server configuration to Claude Desktop’s claude_desktop_config.json, then run main.py in the project directory. Once launched, two MCP tools appear in Claude, enabling weather queries via natural language.
Key features of Weather MCP Server
- Retrieve active weather alerts for a given US state.
- Fetch weather forecasts for a specified latitude and longitude.
- Built with Python, FastMCP, and httpx for async HTTP requests.
- Integrates directly with the National Weather Service (NWS) API.
Use cases of Weather MCP Server
- Asking an AI assistant for current weather alerts in a specific US state.
- Getting a detailed weather forecast for a precise location by coordinates.
- Enabling conversational weather queries in Claude Desktop.
FAQ from Weather MCP Server
What runtime and dependencies are required?
Python 3.11.6 or higher, uv package manager, httpx, and fastmcp. The Claude Desktop app is also needed.
How do I configure the server in Claude Desktop?
Add a weather entry to claude_desktop_config.json pointing to the uv.exe command with the project directory and main.py as arguments.
Does the server support locations outside the United States?
No. The National Weather Service API only provides data for the United States and its territories.
What transports or authentication does the server use?
The README does not specify any authentication; it uses the public NWS API via standard HTTP (httpx) within the FastMCP framework.
How do I start the server after installation?
Run python main.py in the project directory. The server then exposes two tools available in Claude Desktop.
