Skip to main content
Glama
Real-Time Weather MCP Server

Real-Time Weather MCP Server

by kayabhay

🌀️ Real-Time Weather MCP Server

A Model Context Protocol (MCP) server that provides real-time weather information to Claude Desktop and any other MCP-compliant client. Built using FastMCP.


✨ Features

  • Live Weather Data: Real-time conditions, temperatures, and forecasts.

  • Zero API Key Requirement: Uses wttr.in without requiring sign-up or paid subscription keys.

  • FastMCP Powered: High-performance asynchronous tool handling over standard input/output (stdio).

  • Claude Desktop Ready: One-click registration using the mcp CLI or manual JSON configuration.


Related MCP server: mcp-weather-server

πŸ“ Project Structure

real_time_weather-mcp/
β”œβ”€β”€ main.py              # FastMCP server entry point & tool registration
β”œβ”€β”€ tools/
β”‚   β”œβ”€β”€ __init__.py      # Tools package initializer
β”‚   └── weather.py       # Weather fetching logic & API handler
β”œβ”€β”€ pyproject.toml       # Modern Python packaging & dependencies
β”œβ”€β”€ requirements.txt     # Standard pip requirements file
β”œβ”€β”€ .gitignore           # Git ignore configuration
β”œβ”€β”€ LICENSE              # MIT License
└── README.md            # Project documentation

πŸ› οΈ Prerequisites

  • Python: >= 3.10

  • uv (recommended) or standard pip

  • Claude Desktop (optional, for LLM integration)


πŸš€ Quick Start

1. Clone the repository

git clone https://github.com/<your-username>/real_time_weather-mcp.git
cd real_time_weather-mcp

2. Set up environment & install dependencies

Using uv (recommended):

uv venv
.venv\Scripts\activate   # On Windows (or 'source .venv/bin/activate' on macOS/Linux)
uv pip install -e .

Using standard pip:

python -m venv .venv
.venv\Scripts\activate   # On Windows (or 'source .venv/bin/activate' on macOS/Linux)
pip install -r requirements.txt

πŸ”Œ Installing into Claude Desktop

Automatic Installation

Run the FastMCP installer from your activated virtual environment:

mcp install main.py

Note for Windows Store Claude users: If your Claude app was installed from the Microsoft Store, ensure AppData\Roaming\Claude points or links to your local package cache.

Manual Configuration

Add the following to your claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Live Weather": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/absolute/path/to/real_time_weather-mcp/main.py"
      ]
    }
  }
}

Restart Claude Desktop to activate the tool.


πŸ§ͺ Testing & Debugging

You can test the MCP server using the official MCP Inspector:

npx @modelcontextprotocol/inspector uv run main.py

Or run the server directly in stdio mode:

python main.py

πŸ› οΈ Available MCP Tools

Tool

Parameters

Description

check_weather

location (string), detailed (bool, optional)

Fetches real-time weather information for a specified location. If detailed=True, returns temperature, feels-like temp, humidity, wind, and precipitation.


πŸ“„ License

This project is licensed under the MIT License.

Available Tools

1 tool
check_weatherB

Get real-time weather information for a specified location (e.g., "Paris", "New York", "Tokyo").

Args: location: City or location name. detailed: If True, includes feels-like temperature, humidity, wind, and precipitation.

Inputs: location (required), detailed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there is no risk of confusing it with another. Its purpose is clearly stated and distinct.

    Naming Consistency5/5

    The single tool follows a clear verb_noun pattern: check_weather. There are no competing conventions to create inconsistency.

    Tool Count3/5

    A single tool is thin for a server, even one focused on real-time weather. The detailed flag helps, but the surface feels minimal.

    Completeness4/5

    For current real-time weather, the tool covers essential output including optional detailed metrics. It lacks features like forecasts, alerts, or multiple locations, but those may be outside the stated real-time scope.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers