powietrze-mcp

powietrze-mcp 🌫️

Jakość powietrza, smog i pyłki w Polsce – dla Twojego asystenta AI.
Serwer MCP z bieżącymi pomiarami państwowych stacji GIOŚ, indeksem jakości powietrza, ostrzeżeniami smogowymi i prognozą CAMS (Copernicus) na 3 dni. Działa w Claude, ChatGPT, Cursorze i każdym kliencie MCP.

_{Prawdziwa odpowiedź publicznego serwera (22.10.2026, 22:00).}

Podłącz w 30 sekund

Adres MCP: https://powietrze.compabase.com/mcp (Streamable HTTP, bez logowania).

• Claude: Ustawienia → Connectors → Add custom connector → wklej adres.
• ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.
• Claude Code: claude mcp add --transport http powietrze https://powietrze.compabase.com/mcp
• Lokalnie (stdio): npx -y powietrze-mcp, np. w Claude Desktop:

{ "mcpServers": { "powietrze": { "command": "npx", "args": ["-y", "powietrze-mcp"] } } }

Co potrafi

Narzędzie	Do czego
air_quality	Dla miejscowości, adresu albo współrzędnych: najbliższe stacje GIOŚ (do 25 km) z indeksem jakości powietrza (bardzo dobry … bardzo zły), ostatnimi pomiarami PM2.5, PM10, NO2, O3, SO2, średnią dobową pyłów i odniesieniem do norm; ostrzeżenia smogowe GIOŚ w województwie; prognoza na 3 dni z modelu Copernicus CAMS – maksymalne PM2.5/PM10, europejski indeks jakości powietrza i pyłki (brzoza, olsza, trawy, bylica, ambrozja).
air_stations	Stacje pomiarowe GIOŚ w mieście, gminie, powiecie albo województwie.
data_sources	Źródła i zastrzeżenia.

Przykładowe pytania: „Czy mogę dziś pobiegać w Krakowie?”, „Jaki jest smog w Zakopanem i czy jutro będzie lepiej?”, „Czy w weekend będzie dużo pyłków brzozy w Warszawie?”, „Jaka jest jakość powietrza przy ul. Marszałkowskiej 1 w Warszawie?”.

Skąd dane

• Pomiary: Główny Inspektorat Ochrony Środowiska – Państwowy Monitoring Środowiska, API https://api.gios.gov.pl/pjp-api (ok. 290 stacji, wartości godzinowe; dane bieżące są niezweryfikowane). Odpowiedzi trzymamy w pamięci podręcznej (lista stacji 12 h, pomiary i indeks 15 min), żeby nie obciążać GIOŚ.
• Prognoza i pyłki: Copernicus Atmosphere Monitoring Service (CAMS) przez Open-Meteo (CC BY 4.0) – model w siatce ok. 10 km, nie zastępuje pomiaru. Można wyłączyć: POWIETRZE_FORECAST=0.
• Adresy: GUGiK (państwowy rejestr adresów).

Własny serwer

npx -y powietrze-mcp --http --port 3000      # MCP: http://localhost:3000/mcp
npx -y powietrze-mcp now "Kraków, Rynek Główny 1"
npx -y powietrze-mcp stations "małopolskie"

Zmienne: POWIETRZE_FORECAST=0, POWIETRZE_RATE_LIMIT, POWIETRZE_STATS=1 (anonimowe liczniki pod /stats), POWIETRZE_CONTACT, POWIETRZE_PUBLIC_URL.

Licencja

Kod: MIT. Dane: GIOŚ (Państwowy Monitoring Środowiska), Copernicus CAMS / Open-Meteo (CC BY 4.0), GUGiK – dane przetworzone. Projekt niezależny, hostowany pro publico bono przez Compabase. Zobacz też rozkład-mcp, ceny-nieruchomosci-mcp i leki-mcp.

---

English

powietrze-mcp gives AI assistants live air quality in Poland: the nearest official GIOŚ monitoring stations with the Polish air quality index and the latest hourly PM2.5, PM10, NO2, O3 and SO2, smog warnings for the voivodeship, and a 3-day Copernicus CAMS forecast of particulate matter and pollen (birch, alder, grass, mugwort, ragweed). Public endpoint: https://powietrze.compabase.com/mcp (no key), or run locally with npx -y powietrze-mcp.