AirNow MCP Server

AirNow MCP服务器

概述

非官方的AirNow MCP服务器是一种模型上下文协议（MCP）实现，可实现美国空气质量数据的大型语言模型（LLM）和AirNow API之间的集成。该服务器提供了一套全面的工具，允许LLM访问和利用实时、预测和历史空气质量信息。

主要特点

• 通过标准化MCP工具直接访问AirNow API资源
• 查询空气质量数据的自然语言界面
• 支持当前、预测和历史空气质量指数、观测和等高线图
• 通过NPX/Docker轻松集成

关于AirNow API

这 AirNow API 提供对美国官方空气质量数据的访问，包括：

• 当前和预测的空气质量指数（AQI）：\

检索特定位置或地区的臭氧、PM2.5和PM10的实时和预测AQI值。

• 观察和报告区域：\

按邮政编码、纬度/经度、边界框或报告区域访问空气质量观测值。

• 空气质量图：\

获取臭氧和PM2.5的等高线图，以图像或数据叠加的形式提供。

• 历史数据：\

查询支持污染物的历史空气质量数据。

• 健康建议：\

API根据AQI水平提供健康建议和警示声明。

有关端点、参数和响应格式的详细信息，请使用您的AirNow API帐户登录，然后转到 AirNow API Web服务文档.

可用工具

预测

• 预测\_ _ lat_long –按纬度和经度获取报告区域的当前或历史预测AQI值和类别。
• 预报_压缩_编码 –按邮政编码获取报告区域的当前或历史预测AQI值和类别。

等值线图

• 轮廓_地图_地理_边界_边界_区域 –获取KML中的当前或历史臭氧等值线图。
• 轮廓_地图_地理_边界_框_像素25 –获取KML中当前或历史PM2.5等值线图。
• 控制_参数_边界_氧_组合_臭氧\_ pm25 –获取臭氧和PM2.5组合值的KML当前或历史等值线图。

观察

• 当前_观察_报告_反应_平台_龙 –按纬度和经度获取报告区域的当前AQI值和类别。
• 当前_观察_报告_评论_邮编 –按邮政编码获取报告区域的当前AQI值和类别。
• 观测_监测_现场_地理_边界_箱 –获取指定日期和时间范围内的AQI值或数据浓度，以及感兴趣地理区域内的一组参数。

历史数据

• 历史_观察_报道_反应_拉通 –按纬度和经度获取报告区域的历史AQI值和类别。
• 历史观察_报道_反应_压缩码 –按邮政编码获取报告区域的历史AQI值和类别。

需求

• AirNow API密钥，您可以通过请求 AirNow API帐户.
• 对于与NPX一起使用， Node.js >= v22.14.0 是必需的。

配置

克劳德桌面

将以下配置之一添加到您的 claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": "",
        "APPDATA": "" // Windows example: "C:\\Users\\[username]\\AppData\\Roaming"
      }
    }
  }
}

注：

• 对于Windows，通过打开命令提示符并运行以下命令来获取APPDATA值： echo %APPDATA%
• 对于Mac，通过打开终端运行以下命令来获取APPDATA值： which npm

码头工人

{
  "mcpServers": {
    "airnow-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AIRNOW_API_KEY",
        "prsantos/airnow-mcp-server"
      ],
      "env":{
        "AIRNOW_API_KEY": ""
      }
    }
  }
}