# 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](https://github.com/astral-sh/uv) (recommended) or pip for package management

## Installation

1. **Clone the repository:**
   ```bash
   git clone https://github.com/pro-gramming/weather-mcp-server.git
   cd weather
   ```

2. **Install dependencies:**
   
   Using uv (recommended):
   ```bash
   uv sync
   ```
   
   Using pip:
   ```bash
   pip install -e .
   ```

## Project Structure

```
weather/
├── main.py          # Main application entry point
├── weather.py       # Core weather functionality and API integration
├── pyproject.toml   # Project configuration and dependencies
├── README.md        # This file
└── uv.lock          # Locked dependency versions
```

## 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:
```bash
python main.py
```

### Weather API Integration

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

```python
# Example usage (to be implemented)
from weather import get_weather_data

# Get weather for specific coordinates
weather_info = await get_weather_data(latitude=40.7128, longitude=-74.0060)
```

## 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:
   ```bash
   uv sync --dev
   ```

2. Run the application:
   ```bash
   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](LICENSE) file for details.

## Acknowledgments

- [National Weather Service](https://www.weather.gov/) for providing the weather API
- [httpx](https://www.python-httpx.org/) for the excellent HTTP client library
- [FastMCP](https://github.com/modelcontextprotocol/python) for the server framework
- [Official MCP Server](https://github.com/modelcontextprotocol/quickstart-resources/tree/main/weather-server-python) from mcp documenation.