Weather

🚀 Weather MCP Server

This is a Model Context Protocol (MCP) server that uses the National Weather Service API to provide weather information.

🚀 Quick Start

The Weather MCP Server is designed to offer weather - related services. It provides access to weather alerts and detailed forecasts.

✨ Features

• Retrieve weather alerts for US states.
• Obtain detailed weather forecasts for specific locations.

📦 Installation

Prerequisites

• Python 3.12 or higher.
• uv package manager.

Steps

1. Create and activate a virtual environment:

uv venv
source .venv/bin/activate  # On Unix/macOS
# Or
.venv\Scripts\activate     # On Windows

2. Install dependencies:

uv pip install -e .

💻 Usage Examples

Basic Usage

Run the server:

uv run weather-server

The server offers two tools:

1. get_alerts(state): Retrieve weather alerts for a US state.

   • Example: get_alerts("CA") fetches alert information for California.

2. get_forecast(latitude, longitude): Get a weather forecast based on latitude and longitude.

   • Example: get_forecast(38.5816, -121.4944) retrieves the forecast for Sacramento (CA).

📚 Documentation

Configuration in Claude for Desktop

To use this server in Claude for Desktop:

1. Open the ~/Library/Application Support/Claude/claude_desktop_config.json file.
2. Add the following configuration:

{
    "mcpServers": {
        "weather": {
            "command": "/Users/zhihaoouyang/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/zhihaoouyang/Desktop/code/weather",
                "run",
                "weather-server"
            ]
        }
    }
}

3. Restart Claude for Desktop.

Project Structure

weather/
├── mcp-server/           # MCP server implementation
│   └── weather.py       # Main program code
├── pyproject.toml       # Project configuration and dependencies
└── README.md            # This file

Important Note

⚠️ Important Note

This server uses the National Weather Service API and only supports retrieving weather information within the United States.