Openaq

mcp-openaq

OpenAQ MCP — OpenAQ v3 API を介した世界の大気質測定データです。

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

ツール

ツール	説明
air_quality_near	緯度／経度に最も近いモニタリングステーションの最新の大気質測定値（PM2.5、PM10、O3、NO2、SO2、CO など）を取得します。「近くの大気質」「の大気質は？」「今、の空気は汚れていますか」といった質問には、これを優先して使用してください。最寄りのステーションの最新の汚染物質値と、近くにある他のステーションを返します。
find_stations	場所（都市名または地名、座標＋半径（近い順）、国（ISO 3166-1 alpha-2 コード）、または境界ボックス）で OpenAQ の大気質モニタリングステーションを検索します。ステーション ID、名前、国、座標、測定対象の汚染物質（センサー ID を含む）と、都市名が座標から解決された場合にその結果を示す resolved_place を返します。履歴データ系列を取得する最初の手順です。ここでステーションを見つけてから、その sensor_id を get_measurements に渡してください。少なくとも 1 つの場所引数が必要です。このツールはフィルターなしの全世界の一覧は返しません。
get_latest	特定の OpenAQ ステーション（find_stations で取得した場所 ID）の、すべての汚染物質の最新測定値を取得します。各パラメーター（PM2.5、O3、NO2 など）について、値、単位、測定時刻を返します。
get_measurements	1 つの OpenAQ センサー（find_stations で取得したセンサー ID）の、直近の時系列データ（毎時または毎日の集計値）を新しい順に取得します。1 つのステーション／パラメーターにおける汚染物質の経時的な傾向を調べるのに使用します。センサーの最新の limit 件の測定値を返します。多くの OpenAQ センサーはアーカイブされ、何年も前に報告を停止しているため、「最新」のデータが実際には数年前のものである場合があります。データが現在のものだと決めつけず、必ず返されたタイムスタンプを確認してください。現在も報告中のセンサーを選ぶには、find_stations または get_latest を使用してください。

クイックスタート

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 も同じゲートウェイと同じ 1683 以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/air_quality_near \
  -H 'Content-Type: application/json' \
  -d '{"latitude":40.785,"longitude":-73.968}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/air_quality_near を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "openaq": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-openaq"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-openaq

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

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

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

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

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT