# WeatherAPI MCP Server

An MCP server that provides current weather data using WeatherAPI.

## Features

- Get current weather data for any city
- Support for API key via environment variable or command argument
- Easy integration with Claude Desktop App, Windsurf IDE, Cursor IDE, and other MCP clients

## Getting Started

### Get WeatherAPI Key

1. Go to [WeatherAPI.com](https://www.weatherapi.com)
2. Sign up for a free account
3. After signing in, go to your dashboard
4. Copy your API key from the "API Keys" section

### Installation

```bash
npm install -g @maol/weatherapi-mcp
```

### MCP Configuration

Add the following configuration to your MCP config file:

#### Option 1: Using environment variable
```json
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@maol/weatherapi-mcp"],
      "env": {
        "WEATHER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```

#### Option 2: Using command argument
```json
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@maol/weatherapi-mcp", "YOUR_API_KEY_HERE"]
    }
  }
}
```

Replace `YOUR_API_KEY_HERE` with the API key you obtained from WeatherAPI.com.

### Tools

#### get_weather

Get current weather data for a specified city.

Parameters:
- `location` (string): City name

Example response:
```json
{
  "location": "London",
  "country": "United Kingdom",
  "temp_c": 15.0,
  "condition": "Partly cloudy",
  "humidity": 71,
  "wind_kph": 14.4
}
```

### Repository

[WeatherAPI MCP Server](https://github.com/Maol-1997/weatherapi-mcp)

## Author

maol

## License

MIT
