Weather CLI App

What is Weather CLI App?

A lightweight MCP server that fetches active weather alerts and forecasts from the National Weather Service API. It provides two tools for use by AI assistants that support the Model Context Protocol, making real-time U.S. weather data accessible through conversational interfaces.

How to use Weather CLI App?

Install the package with pip install -e . in a Python 3.11+ environment, then configure an MCP-compatible AI assistant to connect to the server. Once connected, the assistant can call the get_alerts tool (US state code) to retrieve active alerts or the get_forecast tool (latitude, longitude) to obtain a 7-day forecast.

Key features of Weather CLI App

• Retrieve active weather alerts for any U.S. state
• Get weather forecasts for any coordinates
• MCP server implementation for AI assistant integration
• Uses National Weather Service API (no API key required)
• Built with httpx for asynchronous HTTP requests

Use cases of Weather CLI App

• An AI assistant notifying a user of severe weather in their state
• Obtaining a forecast to help plan outdoor events or travel
• Embedding weather-driven decision logic into automated agent workflows
• Providing real-time weather context during user conversations

FAQ from Weather CLI App

What data source does this server use?

It uses the National Weather Service (NWS) API. No API key is required, but users should respect NWS rate limits.

What tools does it expose?

Two tools: get_alerts (takes a two-letter US state code) and get_forecast (takes latitude and longitude coordinates).

What are the installation requirements?

Python 3.11 or higher. The package is installed with pip (not uv); it uses the MCP framework, httpx, and the standard MCP server tools.

How do I troubleshoot "spawn uv ENOENT" errors?

This error occurs if the environment tries to use uv instead of pip. Ensure the package is installed with pip and run the server manually via python -m weather to check for additional errors.