mcp-server-one

Kavinduprabasara/mcp-server-one

3.1

If you are the rightful owner of mcp-server-one and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

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