Weather

Provides real-time and historical weather data from multiple sources via MCP with Python and FastAPI.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "digitalgreenorg-agmcp": {
      "command": "python",
      "args": [
        "-m",
        "mcp_weather_server.server"
      ]
    }
  }
}

The MCP Weather Server provides real-time and historical weather data to AI agents through a standard Model Context Protocol interface. It aggregates multiple weather APIs, offers robust data validation and error handling, and exposes a RESTful API you can query from MCP clients to make informed, weather-driven decisions.

How to use

You connect to the MCP Weather Server from an MCP client and request weather data for your desired location and time range. The server delivers current conditions, forecasts, historical data, and alerts in a structured JSON format suitable for direct interpretation by your AI agent. Use it to power location-aware planning, climate-aware decision making, or weather-triggered workflows. If you need premium forecast features, enable the corresponding options via environment configuration and provide any required API keys.

How to install

Prerequisites: Ubuntu, macOS, or Windows with a supported shell; Python 3.8 or higher; pip package manager; internet connection for API access.

Step 1: Install Python dependencies.

pip install -r requirements.txt

Step 2: Prepare environment variables.

Copy the example environment configuration to your actual environment file.

cp .env.example .env

Step 3: (Optional) Configure Tomorrow.io API key for premium features by setting it in your environment file if you have access to that API.

# Example
TOMORROW_API_KEY=your_tomorrow_api_key_here

Step 4: Start the server.

python -m mcp_weather_server.server

Additional configuration examples

The server can be configured to fetch data from multiple weather APIs. If you want to specify data sources or adjust caching and validation behavior, modify environment variables as needed.

# Example mcp server config (as a reference for MCP clients)
{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["-m", "mcp_weather_server.server"]
    }
  }
}