mcpField
M
MCP Weather

MCP Weather

Local
github.com/jpan8866Media & Design0Updated 85w ago
Repository

About MCP Weather

MCP Weather is a Python MCP server that gives AI assistants access to National Weather Service data. It covers active alerts by US state and forecasts for US locations specified by coordinates.

Key features

  1. 01Active alerts by US state
  2. 02Forecasts by latitude and longitude
  3. 03Formatted weather results
  4. 04National Weather Service data

Use cases

  1. 01Check active alerts for a US state
  2. 02Get a forecast for a US location

MCP support

Exposes weather-alert and forecast tools to MCP clients, using National Weather Service data.

Configuration

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

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

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

MCP Weather

A weather information service built with the Model Control Protocol (MCP) framework that provides access to National Weather Service (NWS) data.

Overview

MCP Weather is a Python application that serves as an MCP tool, allowing AI assistants to access real-time weather information from the National Weather Service API. The service provides two main functionalities:

  1. Weather Alerts: Get active weather alerts for any US state
  2. Weather Forecasts: Get detailed weather forecasts for any location in the US by latitude and longitude

Features

  • Retrieve active weather alerts by US state code
  • Get detailed weather forecasts for specific locations
  • Clean, formatted output for easy reading
  • Built as an MCP tool for seamless integration with AI assistants

Requirements

  • Python 3.13 or higher
  • Dependencies:
    • httpx
    • mcp[cli]

Installation

  1. Clone this repository: 
    git clone https://github.com/jpan8866/mcp-weather.git
cd mcp-weather
  2. You will need the python package manager uv to run the server 
    curl -LsSf https://astral.sh/uv/install.sh | sh

Usage

Running as an MCP Service

To test the server, run

uv run weather.py

If the server runs successfully without errors, you can make the tool available with the following command:

PATH/uv --directory ABSOLUTE_PATH/mcp-weather run weather.py
Available Tools
Get Weather Alerts

Retrieves active weather alerts for a specified US state.

Parameters:

  • state: Two-letter US state code (e.g., CA, NY)
Get Weather Forecast

Retrieves a detailed weather forecast for a specific location.

Parameters:

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

API Reference

The application uses the National Weather Service API to fetch weather data.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

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.