Skip to main content
Glama
Sign In
powietrze-mcp

powietrze-mcp

by ContentWriterco
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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"] } } }

Related MCP server: gios-air-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.

Available Tools

3 tools
air_qualityAir quality now and forecast (Poland)A
Read-only
Inspect

Current air quality near a place in Poland from the nearest official GIOŚ stations: Polish air quality index, latest hourly PM2.5, PM10, NO2, O3, SO2 (+24 h means for dust), reference limits, active smog warnings for the voivodeship, and a 3-day forecast of PM and pollen (birch, alder, grass, mugwort, ragweed) from Copernicus CAMS. place: town, address or 'lat,lon'.

Inputs: place (required), forecast, stations.

air_stationsGIOŚ monitoring stationsA
Read-only
Inspect

List official air monitoring stations (GIOŚ) in a town, commune, county or voivodeship, with coordinates.

Inputs: query (required).

data_sourcesData sourcesC
Read-only
Inspect

Where the data comes from and caveats.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct purposes: station discovery, data provenance/context, and air quality retrieval for a place. An agent can easily choose between listing stations, reading source caveats, and fetching current/forecast air quality.

    Naming Consistency5/5

    All tool names use consistent snake_case noun phrases: air_stations, data_sources, air_quality. There is no mixing of casing or verb styles, and each name directly reflects its tool's scope.

    Tool Count5/5

    Three tools is well-scoped for a focused air quality server: one for station lookup, one for data provenance, and one for the main air quality query. Each tool earns its place without redundant surface area.

    Completeness4/5

    The surface covers the core workflow: find stations, understand data caveats, and retrieve current plus forecast air quality including pollutants and pollen. Minor gaps exist around station-specific detailed measurements or historical queries, but typical agent needs are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers