Weather MCP Server

Weather App

A Python-based weather application that provides weather information using the National Weather Service (NWS) API. This project is built with modern Python tools and supports both synchronous and asynchronous HTTP requests.

Features

• 🌤️ Real-time weather data from National Weather Service API
• 🚀 Built with FastMCP for efficient server communication
• 📡 HTTP client support with httpx
• 🐍 Modern Python 3.13+ compatibility
• 🔧 Easy setup and configuration

Prerequisites

• Python 3.13 or higher
• uv (recommended) or pip for package management

Installation

1. Clone the repository:
   git clone https://github.com/pro-gramming/weather-mcp-server.git cd weather
2. Install dependencies:Using uv (recommended):
   uv sync
   Using pip:
   pip install -e .

Project Structure

Dependencies

• httpx (>=0.28.1): Modern HTTP client for Python with async support
• mcp[cli] (>=1.9.4): FastMCP server framework for efficient communication

Usage

Basic Usage

Run the main application:

Weather API Integration

The project is set up to integrate with the National Weather Service API:

API Configuration

The application is configured to use the National Weather Service API:

• Base URL: https://api.weather.gov
• User Agent: weather-app/1.0

Development

Setting up the development environment

1. Install development dependencies:
   uv sync --dev
2. Run the application:
   python main.py

Project Configuration

The project uses pyproject.toml for configuration, which includes:

• Python version requirement (>=3.13)
• Project metadata
• Dependencies specification

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• National Weather Service for providing the weather API
• httpx for the excellent HTTP client library
• FastMCP for the server framework
• Official MCP Server from mcp documenation.