mcpField
W
Weather MCP Server

Weather MCP Server

Local
github.com/devilcoder01Media & Design24Updated 62w ago
Repository

About Weather MCP Server

Weather MCP Server is a simple MCP server built with FastAPI and the MCP framework, providing weather data to AI assistants. It relies on the WeatherAPI service and suits developers who need basic weather information.

Key features

  1. 01Current conditions and 1 to 14 day forecasts
  2. 02Historical weather data
  3. 03Weather alerts and air quality information
  4. 04Astronomy data and location search
  5. 05Timezone information and sports events

Use cases

  1. 01Asking an AI assistant for a city's forecast for the coming week
  2. 02Checking air quality and weather alerts for a location
  3. 03Retrieving sunrise, sunset and moon phase data

MCP support

This project is an MCP server that exposes weather-related tools, such as current conditions, forecasts and air quality, to MCP clients.

#weather-api#mcp-server#weather-mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "weather-mcp-server-devilcoder01": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Weather MCP Server

Trust Score smithery badge

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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.