MCP Weather Server

A Model Context Protocol (MCP) server that provides hourly and daily weather forecasts using the AccuWeather API.

Quick Start

You need an AccuWeather API key (free tier available).
Sign up here and create an app to get your key.

Export your API key as an environment variable:

export ACCUWEATHER_API_KEY=your_api_key_here

Then run the MCP Weather server directly with:

npx -y @timlukahorstmann/mcp-weather

Or, for HTTP/REST access via supergateway:

npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
  --port 4004 \
  --baseUrl http://127.0.0.1:4004 \
  --ssePath /messages \
  --messagePath /message \
  --cors "*" \
  --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"

MCP Server Config Example

For integration with Claude Desktop or other MCP-compatible clients, add this to your config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@timlukahorstmann/mcp-weather"],
      "env": {
        "ACCUWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Overview

This MCP server allows large language models (like Claude) to access real-time weather data. When integrated with an LLM, it enables the model to:

• Fetch accurate, up-to-date weather forecasts
• Provide hourly weather data for the next 12 hours
• Access daily weather forecasts for up to 15 days
• Display data in both metric (°C) and imperial (°F) units
• View temperature, conditions, precipitation information, and other weather details

Available Tools

Hourly Weather Forecast

• Tool name: weather-get_hourly
• Provides hourly forecasts for the next 12 hours
• Parameters:
  • location (required): City or location name
  • units (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)

Daily Weather Forecast

• Tool name: weather-get_daily
• Provides daily forecasts for up to 15 days
• Parameters:
  • location (required): City or location name
  • days (optional): Number of forecast days (1, 5, 10, or 15; default is 5)
  • units (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)

Prerequisites

• Node.js ≥18
• An AccuWeather API key (set via .env or your shell)

Setup

1. Clone this repository:

   git clone https://github.com/TimLukaHorstmann/mcp-weather.git
   cd mcp-weather
   

2. Install dependencies:

   npm install
   

3. Get an AccuWeather API key:

   • Register at AccuWeather API
   • Create a new app and obtain an API key

4. Create a .env file with your API key:

   ACCUWEATHER_API_KEY=your_api_ke
   

... View full README on GitHub