Metadata-Version: 2.4
Name: meteologix-mcp
Version: 0.1.0
Summary: MCP server for Meteologix city search and fccompact forecasts
Author: Meteologix MCP contributors
License-Expression: MIT
Project-URL: Homepage, https://pypi.org/project/meteologix-mcp/
Keywords: mcp,meteologix,weather,forecast,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<1,>=0.28
Requires-Dist: mcp<2,>=1.27
Dynamic: license-file

# Meteologix MCP

Python MCP server for Meteologix location search and `fccompact` forecast data.

This package exposes Meteologix as Model Context Protocol tools:

- `meteologix_search_locations`
- `meteologix_list_models`
- `meteologix_get_meteogram`
- `meteologix_get_current`
- `meteologix_get_daily_summary`

## Install

```bash
pip install meteologix-mcp
```

## Run

```bash
meteologix-mcp
```

MCP client configuration:

```json
{
  "mcpServers": {
    "meteologix-weather": {
      "command": "meteologix-mcp"
    }
  }
}
```

## City Search

Use `meteologix_search_locations` first:

```json
{
  "query": "shanghai",
  "limit": 5
}
```

Then pass the returned `city_id` into forecast tools:

```json
{
  "city_id": "1796236",
  "model": "rapid-euro",
  "hours": 48
}
```

The location search uses the Meteologix autocomplete endpoint:

```text
https://search.meteologix.com/xx/autocomplete/jp/jp?q=shanghai&lang=EN&action=wetter&tab=
```

Forecast tools use:

```text
https://meteologix.com/ajax_pub/fccompact
```

## Notes

`fccompact` and autocomplete are Meteologix web endpoints observed from the public site. They are not documented as a public stability contract by Meteologix. Use reasonable request volume and respect Meteologix terms.

## Maintainer Release

```bash
python -m build --no-isolation --outdir python_dist
python -m twine check python_dist/*
TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... python -m twine upload python_dist/*
```
