Airnow MCP Server

🚀 AirNow MCP 服務器

非官方的 AirNow MCP 服務器是一個模型上下文協議（MCP）的實現方案，它能夠實現大語言模型（LLMs）與用於獲取美國空氣質量數據的 AirNow API 之間的集成。該服務器提供了一套全面的工具，允許大語言模型訪問和利用即時、預測和歷史空氣質量信息。

✨ 主要特性

• 通過標準化的 MCP 工具直接訪問 AirNow API 資源。
• 提供用於查詢空氣質量數據的自然語言接口。
• 支持獲取當前、預測和歷史的空氣質量指數（AQI）、觀測數據和等值線圖。
• 可通過 NPX/Docker 輕鬆集成。

📚 詳細文檔

關於 AirNow API

AirNow API 提供對美國官方空氣質量數據的訪問，包括：

• 當前和預測的空氣質量指數（AQI）：可檢索特定地點或區域的臭氧、PM2.5 和 PM10 的即時和預測 AQI 值。
• 觀測數據和報告區域：可通過郵政編碼、經緯度、邊界框或報告區域訪問空氣質量觀測數據。
• 空氣質量地圖：可獲取臭氧和 PM2.5 的等值線圖，以圖像或數據疊加的形式提供。
• 歷史數據：可查詢受支持汙染物的歷史空氣質量數據。
• 健康建議：該 API 根據 AQI 級別提供健康建議和警示聲明。

有關端點、參數和響應格式的詳細信息，請使用您的 AirNow API 賬戶登錄並訪問 AirNow API Web 服務文檔。

可用工具

預測工具

• 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 示例: "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>"
      }
    }
  }
}