Metadata-Version: 2.4
Name: weather-mcp-v1
Version: 0.1.1
Summary: A weather MCP server using WeatherAPI
Project-URL: Homepage, https://github.com/yourusername/weather-mcp
License: MIT
Keywords: ai,claude,mcp,weather
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# weather-mcp

A weather MCP server powered by [WeatherAPI](https://www.weatherapi.com/).

## Installation

```bash
pip install weather-mcp-v1
```

## Setup

1. Get a free API key from [weatherapi.com](https://www.weatherapi.com/)
2. Set the environment variable:

```bash
# Linux/Mac
export WEATHER_API_KEY=your_api_key_here

# Windows
set WEATHER_API_KEY=your_api_key_here
```

Or create a `.env` file in your working directory:
```
WEATHER_API_KEY=your_api_key_here
```

## Usage

### Run as SSE server
```bash
weather-mcp
```
Server starts at `http://localhost:8000/sse`

### Connect from your MCP client
```python
from mcp.client.sse import sse_client
from mcp import ClientSession

async with sse_client("http://localhost:8000/sse") as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
```

### Connect with Claude Desktop
Add this to your `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "weather": {
      "command": "weather-mcp",
      "env": {
        "WEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Available Tools

### `get_weather`
Fetches current weather for a given location.

**Input:**
- `location` (string) — city name, postal code, coordinates

**Output:** Full weather JSON from WeatherAPI including temperature, condition, humidity, wind, etc.

## License
MIT
