https://github.com/adhikasp/mcp-weather

MCP server that provides hourly weather forecasts using the AccuWeather API
https://github.com/adhikasp/mcp-weather

Last synced: 8 months ago
JSON representation

MCP server that provides hourly weather forecasts using the AccuWeather API

• Host: GitHub
• URL: https://github.com/adhikasp/mcp-weather
• Owner: adhikasp
• License: unlicense
• Created: 2025-01-01T07:44:32.000Z (12 months ago)
• Default Branch: master
• Last Pushed: 2025-01-01T08:48:13.000Z (12 months ago)
• Last Synced: 2025-05-12T19:23:10.554Z (8 months ago)
• Language: Python
• Size: 19.5 KB
• Stars: 7
• Watchers: 1
• Forks: 6
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• metorial-index - Weather Server - Provides hourly weather forecasts by utilizing the AccuWeather API to fetch and deliver weather data for specified locations. (APIs and HTTP Requests)

README

          
# MCP Weather Server

A simple MCP server that provides hourly weather forecasts using the AccuWeather API.

## Setup

1. Install dependencies using `uv`:

```bash

uv venv

uv sync

```

2. Create a `.env` file with your AccuWeather API key:

```

ACCUWEATHER_API_KEY=your_api_key_here

```

You can get an API key by registering at [AccuWeather API](https://developer.accuweather.com/).

## Running the Server

```json

{

    "mcpServers": {

        "weather": {

            "command": "uvx",

            "args": ["--from", "git+https://github.com/adhikasp/mcp-weather.git", "mcp-weather"],

            "env": {

                "ACCUWEATHER_API_KEY": "your_api_key_here"

            }

        }

    }

}

```

## API Usage

### Get Hourly Weather Forecast

Response:

```json

{

    "location": "Jakarta",

    "location_key": "208971",

    "country": "Indonesia",

    "current_conditions": {

        "temperature": {

            "value": 32.2,

            "unit": "C"

        },

        "weather_text": "Partly sunny",

        "relative_humidity": 75,

        "precipitation": false,

        "observation_time": "2024-01-01T12:00:00+07:00"

    },

    "hourly_forecast": [

        {

            "relative_time": "+1 hour",

            "temperature": {

                "value": 32.2,

                "unit": "C"

            },

            "weather_text": "Partly sunny",

            "precipitation_probability": 40,

            "precipitation_type": "Rain",

            "precipitation_intensity": "Light"

        }

    ]

}

```

The API provides:

- Current weather conditions including temperature, weather description, humidity, and precipitation status

- 12-hour forecast with hourly data including:

  - Relative time from current time

  - Temperature in Celsius

  - Weather description

  - Precipitation probability, type, and intensity