# 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
```