Weather MCP Server

An MCP (Model Context Protocol) server that provides weather forecasts using OpenStreetMap Nominatim for geocoding and the National Weather Service (Weather.gov) API for forecast data.

Features

• Single tool: get_weather_forecast - Get weather forecasts for any city, state, or address
• Uses OpenStreetMap Nominatim for free geocoding (no API key required)
• Uses Weather.gov API for accurate, free weather data (US locations only)
• Returns detailed forecast periods with temperature, wind, and conditions

Installation

1. Install dependencies:

npm install

2. Build the project:

npm run build

Configuration

Add this server to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/Users/atharvawadekar/Desktop/Projects/WeatherMCP/dist/index.js"]
    }
  }
}

Usage

Once configured, you can ask Claude:

• "What's the weather in Seattle?"
• "Get me the forecast for Miami, FL"
• "What's the weather like in Portland, Oregon?"
• "Tell me the weather for 1600 Pennsylvania Ave, Washington DC"

Tool Details

get_weather_forecast

Input:

• location (string): City name, state, or full address

Output:

• Location name and coordinates
• NWS forecast office
• Multiple forecast periods with:
  • Period name (Today, Tonight, Tomorrow, etc.)
  • Temperature
  • Wind speed and direction
  • Short and detailed forecast descriptions

How It Works

1. Takes a location string (city, state, or address)
2. Geocodes it using OpenStreetMap Nominatim to get latitude/longitude
3. Calls Weather.gov /points/{lat},{lon} to get grid data
4. Fetches the forecast from the returned forecast URL
5. Formats and returns the weather data

Limitations

• US locations only: Weather.gov only provides data for US locations
• Rate limits: Be respectful of Nominatim's usage policy (max 1 request/second)
• Geocoding accuracy: Results depend on OpenStreetMap's geocoding quality

Development

Run in development mode with auto-rebuild:

npm run dev

License

MIT