Airnow MCP Server

🚀 AirNow MCP Server

非公式のAirNow MCP Serverは、大規模言語モデル（LLM）と米国の空気質データを提供するAirNow APIとの統合を可能にするModel Context Protocol（MCP）の実装です。このサーバーは、LLMがリアルタイム、予測、および過去の空気質情報にアクセスして利用するための包括的なツールセットを提供します。

🚀 クイックスタート

非公式のAirNow MCP Serverは、大規模言語モデル（LLM）とAirNow APIを接続するためのMCPの実装です。これにより、LLMは米国の空気質データにアクセスできます。

✨ 主な機能

• 標準化されたMCPツールを通じてAirNow APIリソースに直接アクセスできます。
• 空気質データをクエリするための自然言語インターフェースがあります。
• 現在、予測、および過去のAQI、観測データ、および等高線マップをサポートしています。
• NPX/Dockerを介した簡単な統合が可能です。

📚 ドキュメント

AirNow APIについて

AirNow API を使用すると、以下を含む公式の米国の空気質データにアクセスできます。

• 現在および予測される空気質指数（AQI）：特定の場所または地域のオゾン、PM2.5、およびPM10のリアルタイムおよび予測されるAQI値を取得できます。
• 観測データと報告エリア：郵便番号、緯度/経度、境界ボックス、または報告エリアによって空気質の観測データにアクセスできます。
• 空気質マップ：オゾンおよびPM2.5の等高線マップを画像またはデータオーバーレイとして取得できます。
• 過去のデータ：サポートされている汚染物質の過去の空気質データをクエリできます。
• 健康上の推奨事項：APIはAQIレベルに基づいた健康上の推奨事項と注意事項を提供します。

エンドポイント、パラメータ、およびレスポンス形式の詳細情報については、AirNow APIアカウントでログインし、AirNow API Web Services Documentation を参照してください。

利用可能なツール

予測

• forecast_by_lat_long：緯度と経度によって報告エリアの現在または過去の予測されるAQI値とカテゴリを取得します。
• forecast_by_zip_code：郵便番号によって報告エリアの現在または過去の予測されるAQI値とカテゴリを取得します。

等高線マップ

• contour_maps_by_geographic_bounding_box_ozone：KML形式で現在または過去のオゾン等高線マップを取得します。
• contour_maps_by_geographic_bounding_box_pm25：KML形式で現在または過去のPM2.5等高線マップを取得します。
• contour_maps_by_bounding_box_combined_ozone_pm25：KML形式でオゾンとPM2.5の組み合わせの現在または過去の等高線マップを取得します。

観測データ

• current_observations_by_reporting_area_by_lat_long：緯度と経度によって報告エリアの現在のAQI値とカテゴリを取得します。
• current_observations_by_reporting_area_by_zip_code：郵便番号によって報告エリアの現在のAQI値とカテゴリを取得します。
• observations_by_monitoring_site_by_geographic_bounding_box：関心のある地理的領域内の指定された日付と時間範囲およびパラメータセットのAQI値またはデータ濃度を取得します。

過去のデータ

• historical_observations_by_reporting_area_by_lat_long：緯度と経度によって報告エリアの過去のAQI値とカテゴリを取得します。
• historical_observations_by_reporting_area_by_zip_code：郵便番号によって報告エリアの過去のAQI値とカテゴリを取得します。

📦 インストール

必要条件

• AirNow APIアカウント を申請して取得できるAirNow APIキーが必要です。
• NPXで使用する場合は、Node.js >= v22.14.0 が必要です。

設定

Claude Desktop

claude_desktop_config.json に以下の設定のいずれかを追加してください。

NPX

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": "<YOUR-AIRNOW-API-KEY>",
        "APPDATA": "<Value of APPDATA>" // Windows example: "C:\\Users\\[username]\\AppData\\Roaming"
      }
    }
  }
}

注意：

• Windowsの場合、コマンドプロンプトを開いて echo %APPDATA% を実行すると、APPDATAの値を取得できます。
• Macの場合、ターミナルを開いて which npm を実行すると、APPDATAの値を取得できます。

Docker

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AIRNOW_API_KEY",
        "prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": "<YOUR-AIRNOW-API-KEY>"
      }
    }
  }
}