Weather MCP Server

Overview of Weather MCP Server

What is Weather MCP Server about?

A FastAPI service exposing a Model Context Protocol (MCP) interface that delivers comprehensive weather‑related data—current conditions, multi‑day forecasts, historical records, alerts, air quality, sunrise/sunset times, moon phases, location lookup, timezone info, and sports events.

How to use Weather MCP Server?

1. Install the server (see Installation below).
2. Provide a valid WeatherAPI key in a .env file (WEATHER_API_KEY).
3. Run python main.py to start the FastAPI app (default URL: http://localhost:8000).
4. Call the MCP endpoints from an AI assistant or any HTTP client to retrieve the desired weather data.

Key features of Weather MCP Server

• Current weather conditions
• Forecasts for 1‑14 days
• Historical weather records
• Weather alerts and warnings
• Air‑quality indices
• Astronomical data (sunrise, sunset, moon phases)
• Location search and geocoding
• Timezone information
• Sports event schedules

Use cases of Weather MCP Server

• Enriching conversational AI assistants with up‑to‑date weather information.
• Building custom dashboards or widgets that display local forecasts.
• Integrating weather alerts into home automation or IoT platforms.
• Supplying data for travel planning or event management applications.
• Supporting research or analytics that require historical climate data.

FAQ

• Which API key is required? A WeatherAPI.com key must be placed in the .env file as WEATHER_API_KEY.
• What Python version is needed? Python 3.13 or newer.
• Can I run the server in production? Yes, use a production‑grade ASGI server (e.g., Uvicorn or Hypercorn) behind a reverse proxy.
• Is there a Docker image? Not provided in the repository, but you can containerize the FastAPI app using a standard Python base image.
• How do I install via Smithery? Execute npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claude.

Installation

• Via Smithery: npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claude
• Manual:

  git clone https://github.com/sjanaX01/weather-mcp-server.git
  cd weather-mcp-server
  uv venv
  uv pip install -e .
  echo "WEATHER_API_KEY=your_api_key" > .env
  python main.py
  

Weather MCP Server

A Model Context Protocol (MCP) server for weather data, built with FastAPI and the MCP framework. This server provides various weather-related tools that can be used by AI assistants to retrieve current weather conditions, forecasts, air quality data, and more.

Features

• Current weather conditions
• Weather forecasts (1-14 days)
• Historical weather data
• Weather alerts
• Air quality information
• Astronomy data (sunrise, sunset, moon phases)
• Location search
• Timezone information
• Sports events

Requirements

• Python 3.13+
• uv package manager
• WeatherAPI API key

Installation

Installing via Smithery

To install Weather Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @devilcoder01/weather-mcp-server --client claude

Manual Installation

1. Clone this repository:

   git clone https://github.com/yourusername/Weather_mcp_server.git
   cd Weather_mcp_server
   

2. Install dependencies using uv:

   uv venv
   uv pip install -e .
   

3. Create a .env file in the project root with your WeatherAPI key:

   WEATHER_API_KEY=your_api_key_here
   

Usage

Run the server:

python main.py

The server will start on http://localhost:8000 by default.

License

This project is licensed under the MIT License - see the LICENSE file for details.