mcpField
W
Weather Server (MCP)

Weather Server (MCP)

Local
github.com/KavinduprabasaraMedia & Design0Updated 73w ago

About Weather Server (MCP)

Weather Server (MCP) is a minimal asynchronous Python server for US weather alerts and forecasts, using the National Weather Service API. It is suited to MCP clients that need state alerts or forecasts for coordinates.

Key features

  1. 01Retrieve alerts for a US state
  2. 02Get forecasts by US coordinates
  3. 03Asynchronous Python server

Use cases

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

MCP support

Exposes weather alert and forecast tools to MCP clients. It is built with FastMCP.

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

Weather Server (MCP)

A minimal async Python server that provides weather alerts and forecasts for US locations using the National Weather Service (NWS) API, built with FastMCP.

Features

  • Get weather alerts for any US state (by two-letter code)
  • Get weather forecasts for any latitude/longitude in the US
  • Simple, async, and easy to extend

Requirements

  • Python 3.13+
  • httpx
  • mcp (and FastMCP)
  • uv (for running the server, optional)

Installation

  1. Clone this repository:

    git clone <your-repo-url>
    cd mcp-server-one
    
  2. Install dependencies:

    pip install -e .
    

Usage

You can run the server using the provided configuration (see mcp.json):

uv run --with mcp[cli] mcp run server.py

Or, directly with Python:

python server.py

API Tools

Get Weather Alerts
  • Function: get_alerts(state: str)
  • Description: Returns active weather alerts for a US state (e.g., CA, NY).
Get Weather Forecast
  • Function: get_forecast(latitude: float, longitude: float)
  • Description: Returns the weather forecast for the given coordinates.

Project Structure

server.py         # Main server code
pyproject.toml    # Project metadata and dependencies
mcp.json          # (Optional) MCP/uv run configuration
README.md         # This file

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.