Metadata-Version: 2.4
Name: mcp-multi-weather
Version: 0.2.1
Summary: MCP server for checking the weather history and forecast
Project-URL: Homepage, https://github.com/igalarzab/mcp-multi-weather
Author-email: Jose Galarza <igalarzab@gmail.com>
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: aiohttp[speedups]>=3.12.14
Requires-Dist: dotenv>=0.9.9
Requires-Dist: fastmcp>=2.10.6
Description-Content-Type: text/markdown

# mcp-multi-weather

## Description

MCP server for checking the weather history and forecast. This Model Context Protocol (MCP) server
provides weather data functionality through a FastMCP-based service that integrates with weather
providers to deliver historical weather information.

The server exposes a `get_historical_weather` tool that allows checking weather conditions for
specific cities on past dates, making it useful for applications that need historical weather data.

## How to run it

First you need to create a valid API key with OpenWeather, and set it in your env file:

```
$ cp .env.example .env
$ vim .env # Modify the values
```

Now you can run the server locally:

```
$ uv run mcp-multi-weather
```

Or, you can install the package in your claude-desktop:

```
$ uv run fastmcp install claude-desktop src/mcp_multi_weather/cli/server.py --env-file .env --env PYTHONPATH=$PWD/src/
```

## Development

You can run the tests using pytest:

```
$ uv run pytest
$ uv run pytest --ow-api-key=DUMMY  # To run tests against the real OpenWeather API
```

You can also check the syntax and lint the code with pyright and ruff:

```
$ uv run pyright
$ uv run ruff check
$ uv run ruff format
```
