Powietrze PL (powietrze-mcp)

AI 에이전트를 위한 폴란드 대기질 정보: 공식 GIOŚ 측정소의 실시간 측정값(PM2.5, PM10, NO2, O3, SO2)과 폴란드 대기질 지수, 스모그 경보, Copernicus CAMS의 3일간 미세먼지 및 꽃가루 예보를 제공합니다. 무료이며 API 키가 필요 없습니다.

GitHub

호스팅형 MCP 서버

npx add-mcp 'https://powietrze.compabase.com/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

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.

npm CI Licencja MIT Bez klucza API

Animacja: użytkownik pyta asystenta AI, czy może dziś pobiegać w Krakowie koło Rynku; asystent korzysta z powietrze-mcp i podaje indeks GIOŚ, pomiary PM2.5 i PM10 oraz prognozę smogu na jutro

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ędzieDo czego
air_qualityDla 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_stationsStacje 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

Animation: a user asks an AI assistant whether they can run tonight in Kraków; the assistant uses powietrze-mcp and answers with the GIOŚ index, PM2.5 and PM10 and tomorrow's smog forecast

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.