WeatherAPI MCP Server

An MCP server that provides weather data tools using the WeatherAPI.com service.

Features

This MCP server provides the following tools:

get_current_weather: Get current weather conditions for any location
get_forecast: Get weather forecast (1-10 days) with hourly breakdowns
search_location: Search for locations by name
get_astronomy: Get sunrise, sunset, moon phases, and other astronomy data
get_air_quality: Get air quality index and pollutant levels

Setup

Get a free API key from WeatherAPI.com

Set the API key as an environment variable:

# Windows PowerShell
$env:WEATHERAPI_KEY = "your_api_key_here"

# Or add to your profile for persistence
# Edit $PROFILE and add:
# $env:WEATHERAPI_KEY = "your_api_key_here"

Install using uvx:
```
uvx mcp-weatherapi
```

Usage with MCP Clients

Add this to your MCP configuration:

{
  "mcpServers": {
    "weatherapi": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/bsparks/mcp-weatherapi.git",
        "mcp-weatherapi"
      ],
      "env": {
        "WEATHERAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Development

Clone the repository
Install dependencies:
```
pip install -e .
```

Set your API key:

$env:WEATHERAPI_KEY = "your_api_key_here"

Run the server:
```
python weather_server.py
```

Available Tools

get_current_weather(location: str)

Get current weather conditions including temperature, wind, humidity, air quality, etc.

Example: get_current_weather("London")

get_forecast(location: str, days: int = 3)

Get weather forecast for 1-10 days with daily summaries and hourly data.

Example: get_forecast("New York", 5)

search_location(query: str)

Search for locations by name (minimum 3 characters).

Example: search_location("Paris")

get_astronomy(location: str, date: Optional[str] = None)

Get astronomy information including sunrise, sunset, moonrise, moonset, and moon phases.

Example: get_astronomy("Tokyo", "2025-11-07")

get_air_quality(location: str)

Get air quality index and pollutant levels.

Example: get_air_quality("Beijing")

API Documentation

For more information about the WeatherAPI.com service, visit: https://www.weatherapi.com/docs/

License

MIT

mcp-weatherapi