Epa Aqs

@pipeworx/epa-aqs

EPA 的 Air Quality System——一个质量有保障、符合监管标准的环境空气测量数据档案库，涵盖美国约 10,000 个监测站点。它与 airnow 工具包不同，后者提供最近几天的临时实时 AQI。

属于 Pipeworx——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• aqs_list_parameters(list, pc?, state?, county?) — 参数代码、类别、州、县、站点、机构。
• aqs_sample_data(param, bdate, edate, by?, state?, county?, site?, cbsa?, bbox?, limit?) — 原始测量样本值。
• aqs_annual_summary(param, bdate, edate, ...) — 年均值、最大值、百分位数、超标次数、完整性。
• aqs_monitors(param, bdate, edate, ...) — 监测器元数据、网络、方法、启用／停用日期。

身份验证

目前仅支持自带凭据（BYO）。 EPA AQS 使用两个值进行身份验证：电子邮箱和密钥，二者会一并发放。工具包只有一个凭据槽位，因此两部分都要放在 _apiKey 中：

• ?_apiKey=<email>:<key> — 将电子邮箱和密钥一起提供，或
• ?_apiKey=<key>，并同时提供 email=<your-email>。

免费注册，即时完成：GET https://aqs.epa.gov/data/api/signup?email=<your-email>。 EPA 会将密钥发送到该邮箱地址。

平台备用环境变量为 PLATFORM_EPA_AQS_KEY，且必须以 <email>:<key> 的格式存储。截至 2026-09-17，该变量尚未配置（fleet #2212）——网关已达到 Cloudflare 的 250 个文本绑定上限，因此要通过平台密钥存储库添加，而不是使用 wrangler secret put。

没有免密或演示用路径。 EPA 自己的文档列出了一个共享测试账号（[email protected] / test）；该账号的每日配额已永久耗尽——经验证，截至 2026-09-17，它返回 {"error":"Daily limit for account use exceeded. Retry later."}——因此我们特意没有接入该账号。若将此响应作为数据提供，用户会以为我们的服务发生了故障。

数据源

https://aqs.epa.gov/data/api — 文档见 https://aqs.epa.gov/aqsweb/documents/data_api.html

以下问题原本需要由下一位使用者自行发现：

• 日期格式为 YYYYMMDD，不带分隔符。工具接受 YYYY-MM-DD 格式。
• bdate 和 edate 必须处于同一个日历年。 EPA 的错误响应不会明确说明这一点；此工具包会先检查并说明原因。
• 错误会以 HTTP 200 返回。 身份验证和配额问题会出现在 Header[0].status 中，或以纯粹的 {"error": ...} 形式返回，绝不会使用 4xx 状态码。此处会将两者都作为错误抛出，而不是当作空的 Data 数组处理。
• 每次请求的 param 最多接受 5 个代码。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/epa-aqs/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 都会连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/aqs_list_parameters \
  -H 'Content-Type: application/json' \
  -d '{"list":"classes"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/aqs_list_parameters。查找工具包：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

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

或者直接运行以确认它可以启动：

npx -y @pipeworx/mcp-epa-aqs

它通过 stdin/stdout 使用 MCP 协议通信，并为 initialize/tools/list/tools/call 提供响应，仅包含此工具包的工具——不包含上述网关连接额外提供的共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Epa Aqs data" })

网关会自动选择合适的工具并填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT