Skip to main content
Glama
Sign In
WeatherMCP

WeatherMCP

by pragaurav44
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

WeatherMCP

This project is an MCP server built as a hands-on exercise. It provides weather data and alerts from the US National Weather Service (NWS) via a simple API using the FastMCP framework.

Features

  • Weather Alerts: Get active weather alerts for any US state.

  • Forecast: Retrieve weather forecasts for a specific latitude and longitude.

Related MCP server: Weather MCP Server

Requirements

  • Python 3.8+

  • uv (for dependency management and running)

Installation

  1. Install dependencies using uv:

    uv pip install -r requirements.txt

    Or, if you use pyproject.toml:

    uv pip install -r pyproject.toml

  2. (Optional) Create a virtual environment:

    uv venv .venv
source .venv/bin/activate

Running the MCP Server

To start the server using uv:

uv pip install -e .  # if you want to install as editable, or just ensure dependencies are installed
uv python weather.py

The server will start and listen for MCP requests via stdio.

Available Tools

1. get_alerts(state: str)

  • Description: Get active weather alerts for a US state.

  • Argument: state — Two-letter US state code (e.g., CA, NY).

  • Returns: Formatted string of current alerts or a message if none are found.

2. get_forecast(latitude: float, longitude: float)

  • Description: Get weather forecast for a specific location.

  • Arguments:

    • latitude — Latitude of the location (float)

    • longitude — Longitude of the location (float)

  • Returns: Formatted string with the next 5 forecast periods.

Notes

Feel free to extend or modify the project for your own experiments!

Available Tools

2 tools
get_alertsA

Get weather alerts for a US state.

Args:
    state: Two-letter US state code (e.g. CA, NY)

Inputs: state (required).

get_forecastB

Get weather forecast for a location.

Args:
    latitude: Latitude of the location
    longitude: Longitude of the location

Inputs: latitude (required), longitude (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: get_alerts retrieves weather alerts for US states, while get_forecast provides forecasts for geographic coordinates. There is no overlap in functionality or ambiguity between them.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (get_alerts, get_forecast) with identical verb usage and snake_case formatting. The naming is perfectly predictable and uniform.

    Tool Count2/5

    With only 2 tools, this server feels thin for a weather domain. It lacks basic operations like current conditions, historical data, or broader geographic coverage, making it insufficient for comprehensive weather-related tasks.

    Completeness2/5

    The tool surface is severely incomplete for weather functionality. It misses core operations such as current weather, historical data, multi-day forecasts, or international coverage, leaving significant gaps that will limit agent effectiveness.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches