# Weather MCP Server Powered by the Open-Meteo API

This MCP server interfaces with the Open-Meteo API and offers tools to fetch current weather conditions and weather forecasts for any location worldwide.

## Requirements

- Claude.ai account (MCP support is available for all account types)
- Claude Desktop app, available for macOS and Windows
- uv:
  - macOS via Homebrew: `brew install uv`
  - Windows via WinGet: `winget install --id=astral-sh.uv -e`
- A code editor like Visual Studio Code

## Installation

```bash
uv run
```

## Development

Start the virtual environment

```bash
source .venv/bin/activate
```

NOTE: To stop the virtual environment:

```bash
deactivate
```

Run MCP server in dev mode with the MCP Inspector:

```bash
mcp dev server.py
```

## Run MCP server in Claude Desktop

Open `claude_desktop_config.json` in an editor:

File location:

- MacOS / Linux: `~/Library/Application/Support/Claude/claude_desktop_config.json`
- Windows: `AppData\Claude\claude_desktop_config.json`

Find the full path to uv:

- MacOS / Linux: `which uv`
- Windows: `where uv`

In `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "weather": {
      "command": "/absolute/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/absolute/path/to/mcp-server-weather/server.py"
      ]
    }
  }
}
```

Reboot Claude Desktop and use a prompt that will trigger your MCP.

## Usage

In Claude Desktop:

- request current weather information for a specified location
- request a weather forecast for a specified location and time
- ask if it's going to rain tomorrow
- ask if you need to put on sunscreen if you're going for a walk later