Skip to main content
Glama

mcp-openaq

OpenAQ MCP — OpenAQ v3 API による世界の大気質測定データ。

Pipeworx の一部 — AI エージェントを 1476+ のライブデータソースに接続する MCP ゲートウェイです。

ツール

ツール

説明

air_quality_near

指定された緯度・経度に最も近い測定局で、最新の大気質測定値(PM2.5、PM10、O3、NO2、SO2、CO など)を取得します。「近くの大気質」「 の大気質は?」「 の今の空気は悪い?」といった質問に適しています。最寄りの測定局と、その最新の汚染物質値に加えて、近隣の他の測定局も返します。

find_stations

場所に基づいて OpenAQ 大気質測定局を検索します:都市名または地名、座標+半径(近い順)、国(ISO 3166-1 alpha-2 コード)、またはバウンディングボックス。測定局の ID、名前、国、座標、各測定局が測定する汚染物質(センサー ID 付き)に加えて、都市名が解決された座標を反映する resolved_place を返します。これは履歴時系列の最初のステップです:ここで測定局を見つけ、その sensor_id を get_measurements に渡します。場所の引数が少なくとも1つ必要です — フィルタリングされていない全世界のリストは返されません。

get_latest

特定の OpenAQ 測定局(find_stations の location id で指定)におけるすべての汚染物質の最新測定値を取得します。各パラメータ(PM2.5、O3、NO2 など)について、値、単位、測定時刻を返します。

get_measurements

単一の OpenAQ センサー(find_stations のセンサー ID)の最新の時系列(時間別または日別の集計)を新しい順で取得します。1つの測定局/パラメータにおける経時的な汚染物質の傾向を調べるために使用します。センサーの最後の limit 件の測定値を返します。注意:多くの OpenAQ センサーはアーカイブされ、何年も前に報告を停止しています。そのため「最新」が正当に数年前になることがあります。データが現在のものであると決めつけず、常に返されたタイムスタンプを確認してください。まだ報告中のセンサーを選ぶには、find_stations または get_latest を使用してください。

Related MCP server: gios-air-mcp

クイックスタート

MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:

{
  "mcpServers": {
    "openaq": {
      "url": "https://gateway.pipeworx.io/openaq/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/openaq/mcp の tools/list は、上記の表のツールに加えて共有の Pipeworx メタツール(ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できる一連のツール)も返します。したがって、表示されるツール数はこの表より多くなります。単一パックのエンドポイントでは現在、パック独自のツールに加えて約30の共有ツールが一覧表示されます。接続の initialize レスポンスは正確なスコープを示し、その日の権威ある回答となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールは、スコープが限定された接続が、このパックがカバーしない質問に対して、カタログ全体にルーティングする ask_pipeworx を介して、別の MCP サーバーを追加することなく回答できるようにするものです。現在、メタツールなしでパックエンドポイントをマウントする方法はありません。追加のスキーマがルーティングの価値よりも多くのコンテキストを消費する場合は、複数のパックエンドポイントに接続するのではなく、完全なゲートウェイに一度接続してください。

または、完全な Pipeworx ゲートウェイに接続すると、このパックのツールだけではなく、すべてのパックのツールが直接一覧表示されます:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1476+ のデータソースに到達します。唯一の違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx はどちらの URL からもすべてのツールに到達できます。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問することができます。これは上記のパックエンドポイントでも、完全なゲートウェイでも機能します:

ask_pipeworx({ question: "your question about Openaq data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

ライセンス

MIT

Related MCP Connectors

Related MCP Servers