Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

bartosz-kuc/honest-imgw-mcp

БесплатноНе проверен

Polish weather and hydrology data from the IMGW-PIB public API, no API key: hourly synoptic observations (getweather), river levels and flow with a computed nor

GitHubEmbed

Описание

Polish weather and hydrology data from the IMGW-PIB public API, no API key: hourly synoptic observations (getweather), river levels and flow with a computed normal/warning/alarm status (gethydro), active weather warnings (getwarnings), and station lists. Queries IMGW directly, no middleman.

README

Local MCP server for IMGW-PIB (Polish Institute of Meteorology and Water Management) public data feed — current weather, hydrological readings, and active meteorological warnings across Poland.

Part of the honest-mcp family of small, auditable, local-first MCP servers.

Why

Anyone in Poland who watches river levels (flood-plain landlord, kayaker, farmer), plans outdoor work, or just wants a native alternative to yr.no or the ECMWF apps can hand IMGW's raw feed to their AI in one line. No API key. No rate limit worth worrying about.

Features

Five tools:

  • get_weather — current synoptic observations. Whole country (~60 stations) or one station.
  • get_hydro — hydrological readings. Water level, flow, water temperature, alarm/warning thresholds. Server annotates each with computed alarm_status (normal / warning / alarm).
  • get_warnings — active IMGW meteorological warnings (storms, frost, heat, precipitation, wind) with severity and validity window.
  • list_weather_stations — station-name index for get_weather.
  • list_hydro_stations — station index with rivers and provinces, filterable, for get_hydro.

Data source

  • Endpoint: danepubliczne.imgw.pl/api/data — IMGW public data feed
  • No API key
  • Refresh: synop hourly, hydro every ~20 minutes, warnings whenever a new one is issued

Requirements

  • Python 3.10+

Setup

git clone https://github.com/bartosz-kuc/honest-imgw-mcp.git
cd honest-imgw-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt

On Windows use python instead of python3, and venv\Scripts\pip / venv\Scripts\python instead of the venv/bin/... paths shown here and below.

Register with Claude Code:

claude mcp add imgw /absolute/path/to/venv/bin/python /absolute/path/to/server.py

Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "imgw": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Example usage

"What's the temperature in Warsaw right now?"

get_weather(station="warszawa") → single-station JSON with temperature, wind, humidity, precipitation, pressure.

"Any active storm warnings?"

get_warnings() → list of active warnings, filter yourself by nazwa_zdarzenia.

"Any rivers in Mazowieckie above alarm level?"

get_hydro(province="mazowieckie", only_alerts=true) → just stations where current level ≥ alarm threshold.

Data flow

Your AI client
     ↕  MCP stdio
This server (Python, on your machine)
     ↕  HTTPS
danepubliczne.imgw.pl

No cloud middle. No telemetry.

Author

Bartosz Kuć — Warsaw-based developer, JDG owner running skanfirmy.pl.

Consulting

Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams. See skanfirmy.pl/uslugi for productized packages (audit 3k PLN, setup 8-15k PLN, retainer 2-4k PLN/mo), or reach out via email.

License

MIT — see LICENSE.

Related

from github.com/bartosz-kuc/honest-imgw-mcp

Установка bartosz-kuc/honest-imgw-mcp

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/bartosz-kuc/honest-imgw-mcp

FAQ

bartosz-kuc/honest-imgw-mcp MCP бесплатный?

Да, bartosz-kuc/honest-imgw-mcp MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для bartosz-kuc/honest-imgw-mcp?

Нет, bartosz-kuc/honest-imgw-mcp работает без API-ключей и переменных окружения.

bartosz-kuc/honest-imgw-mcp — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить bartosz-kuc/honest-imgw-mcp в Claude Desktop, Claude Code или Cursor?

Открой bartosz-kuc/honest-imgw-mcp на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare bartosz-kuc/honest-imgw-mcp with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development