Skip to main content
Glama

mcp-openaq

OpenAQ MCP — 通过 OpenAQ v3 API 获取全球空气质量数据。

Pipeworx 的一部分 — 一个将 AI 代理连接到 1476+ 个实时数据源的 MCP 网关。

工具

工具

描述

air_quality_near

获取距离某经纬度最近的监测站的最新空气质量读数(PM2.5、PM10、O3、NO2、SO2、CO 等)。适用于"我附近的空气质量"、"<坐标>的空气质量如何"、"<地点>现在的空气是否糟糕"等查询。返回最近的监测站及其最新污染物数值,以及附近的其他监测站。

find_stations

按位置查找 OpenAQ 空气质量监测站:城市或地名、坐标+半径(按距离最近排序)、国家(ISO 3166-1 alpha-2 代码)或边界框。返回站点 id、名称、国家、坐标,以及每个站点监测的污染物(含传感器 id),还有 resolved_place 回显城市名称解析到的坐标。这是获取历史序列的第一步:先在这里找到站点,然后将其 sensor_id 传给 get_measurements。至少需要一个位置参数 — 该工具不会返回未过滤的全局列表。

get_latest

获取指定 OpenAQ 站点(使用 find_stations 返回的 location id)每种污染物的最新读数。返回每个参数(PM2.5、O3、NO2 等)及其数值、单位和测量时间。

get_measurements

获取单个 OpenAQ 传感器(使用 find_stations 返回的 sensor id)的最近时间序列(小时或日聚合),按最新优先排序。用于查看单个站点/参数的污染物随时间变化的趋势。返回该传感器最后 limit 条读数 — 请注意,许多 OpenAQ 传感器已归档并在多年前停止上报,因此"最近"的数据可能确实是几年前的:务必读取返回的时间戳,而不要假设数据是当前的。请使用 find_stations 或 get_latest 选择仍在上报的传感器。

Related MCP server: gios-air-mcp

快速开始

添加到你的 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 服务器。目前无法在不包含这些元工具的情况下挂载包端点;如果额外的 schema 消耗的上下文比路由带来的价值更多,请直接连接完整网关,而不是连接多个包端点。

或者连接到完整的 Pipeworx 网关,直接列出所有包的工具,而不仅仅是这一个的:

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

两个 URL 都指向同一个网关和相同的 1476+ 个数据源。唯一的区别是哪个包的工具被直接列出;ask_pipeworx 从任一入口都能访问所有工具。

与 ask_pipeworx 配合使用

无需直接调用工具,你可以用自然语言提问 — 这在上面的包端点和完整网关上都可以使用:

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

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

更多

许可证

MIT

Related MCP Connectors

Related MCP Servers