nws-claude-mcp

Claude-NWS Protocol Bridge

A Model Context Protocol (MCP) server that integrates the US National Weather Service API with Claude Desktop, providing real-time weather data and forecasts directly within your Claude conversations.

Features

• 🌤️ Real-time weather conditions and forecasts
• 🗺️ Location-based weather queries using coordinates or place names
• ⚡ Seamless integration with Claude Desktop via MCP
• 🔄 Live data from the official US National Weather Service API
• 📊 Detailed weather metrics including temperature, humidity, wind, and precipitation

Prerequisites

• Claude Desktop App
• Python (v3.12 or higher)
• uv package manager
• Internet connection for API access

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/claude-nws-protocol-bridge.git
   cd claude-nws-protocol-bridge
   

2. Install dependencies:

   uv sync
   

3. Configure the MCP server in your Claude Desktop settings:

   {
    "mcpServers": {
      "nws-weather": {
        "command": "uv",
        "args": ["run", "python", "weather.py"]
      }
    }
   }
   

Usage

Once configured, you can ask Claude weather-related questions such as:

• "What's the current weather in San Francisco?"
• "Give me a 7-day forecast for New York City"
• "What's the temperature and humidity right now?"
• "Is it going to rain today in Seattle?"

API Reference

The bridge provides the following MCP tools:

get-current-weather

Retrieves current weather conditions for a specified location.

Parameters:

• location (string): City name, coordinates, or ZIP code

get-weather-forecast

Gets weather forecast data for a specified location.

Parameters:

• location (string): City name, coordinates, or ZIP code
• days (number, optional): Number of forecast days (default: 7)