mcpField
W
Weather CLI App

Weather CLI App

Local
github.com/aryankarnMedia & Design0Updated 78w ago
Repository

About Weather CLI App

A Python MCP server that retrieves weather alerts and forecasts from the National Weather Service API. It is intended for MCP-compatible AI assistants and provides alerts by US state and forecasts by coordinates.

Key features

  1. 01Get active alerts for a US state
  2. 02Fetch forecasts by coordinates
  3. 03Uses the National Weather Service API
  4. 04No API key required

Use cases

  1. 01Check active weather alerts for a state
  2. 02Get a forecast for a location's coordinates

MCP support

The MCP server exposes `get_alerts` and `get_forecast` tools to compatible AI assistants.

#weather-cli#weather-app#mcp-server

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 CLI App

A simple application to fetch weather alerts and forecasts from the National Weather Service API using Model Context Protocol (MCP).

Features

  • Get active weather alerts for any US state
  • Get weather forecasts for any location by coordinates
  • MCP server implementation for integration with AI assistants

Installation

  1. Ensure you have Python 3.11 or higher installed
  2. Clone this repository
  3. Install the package with pip:
# Install with pip
pip install -e .

# Or if you have pip3 specifically
pip3 install -e .

Note: This project uses the MCP framework and does NOT require the uv tool specifically, despite what the lock file might suggest.

Usage as an MCP Server

Once installed, the weather MCP server can be accessed by AI assistants that support the Model Context Protocol. The server provides two main tools:

  1. get_alerts - Get weather alerts for a US state (using two-letter state code)
  2. get_forecast - Get weather forecast for specific coordinates (latitude, longitude)

Development

This project uses:

  • httpx for asynchronous HTTP requests
  • MCP server tools for structured data handling
Troubleshooting

If you see errors like spawn uv ENOENT in the logs:

  1. Make sure you've installed the package with pip, not uv
  2. Check that your Python environment is properly configured
  3. Try running the server manually to see any additional stderr output: python -m weather

API Information

This application uses the National Weather Service (NWS) API to retrieve weather data. No API key is required, but please be respectful of their rate limits.

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.