wellness-air

Wellness Air

面向 AI Agent 的本地优先空气质量 MCP。
将 AirGradient/AirThings/PurpleAir 传感器接入你的 Agent — 没有任何令牌会离开你的设备。

📡 项目缘起：你的睡眠 / 专注力 / 训练效果在一定程度上取决于室内环境质量。PM2.5 超过 35、CO₂ 超过 1,000 ppm、湿度偏低 — 这些都会损害恢复，而 Agent 无法感知这些情况。wellness-air 为任何 AI Agent 提供本地优先的环境信息，可与 WHOOP / Oura / Garmin / nourish 的数据交叉分析。

⚡ 一键安装 — 选择你的运行环境：

• 适用于 Hermes 的 Delx Wellness：npx -y delx-wellness-hermes setup
• 适用于 OpenClaw 的 Delx Wellness：npx -y delx-wellness-openclaw setup

也可以单独接入 Claude Desktop / Cursor / ChatGPT Desktop — 请参阅下方的安装部分。

---

HTTP（v2 无状态）

默认传输方式为 stdio。也可选择 Streamable HTTP — 无会话 ID、返回 JSON 响应，仅限环回地址：

npx -y wellness-air --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

环境变量：WELLNESS_AIR_HOST、WELLNESS_AIR_PORT、WELLNESS_AIR_TRANSPORT=http。

概览

Wellness Air 是一款本地 MCP 服务，可向任何兼容 MCP 的 AI Agent 提供空气质量读数。它原生支持 AirGradient（开源硬件 + 免费公共 API — 全球数据流中的 2,000 多个公共传感器无需身份验证）。AirThings 和 PurpleAir 已实现支持（需自备免费的 API 凭据）；IQAir AirVisual 和 Awair 已列入路线图。

如果 wellness-air 对你的 Agent 有帮助，请为仓库点个星。星标有助于其他 AI 开发者发现这个项目，也能支持 Delx 持续推出本地优先的健康基础设施。

60 秒快速体验

# 89 is a real, public AirGradient sensor (Prem Tinsulanonda School, Thailand).
# Swap in one near you from https://www.airgradient.com/map/ — copy the numeric
# locationId from the URL.

WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air doctor
WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air current

就这么简单 — 无需令牌、无需注册、没有遥测数据。公共读取通过 AirGradient 不需要令牌的全球数据流进行，因此该数据流中的任何 locationId 都可以开箱即用。

在 Claude Desktop / Cursor / ChatGPT Desktop / Codex 中安装

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": ["-y", "wellness-air"],
      "env": {
        "WELLNESS_AIR_DEFAULT_PROVIDER": "airgradient",
        "WELLNESS_AIR_DEFAULT_LOCATION": "89"
      }
    }
  }
}

重新加载客户端。Agent 现在可以使用 19 个空气质量工具。

工具（共 19 个）

工具	用途
air_agent_manifest	运行时契约：工具列表、支持的客户端、环境变量、建议的首次调用
air_capabilities	支持的提供商、已配置的提供商、可用指标、隐私模式
air_connection_status	健康检查 + Agent 应提示用户注意的警告
air_privacy_audit	哪些内容在本地记录，哪些内容发送给提供商
air_data_inventory	指标目录 + AQI 区间阈值
air_current_reading	最新传感器读数（PM2.5、CO₂、AQI、温度、湿度）
air_list_devices	列出经过身份验证的提供商账户（AirThings）中的设备
air_aqi_check	快速回答“空气状况好吗？”，并提供区间和建议
air_daily_summary	综合每日快照
air_compare_locations	比较 2–10 个地点的 AQI
air_search_public_sensors	用于查找 AirGradient 公共地图的辅助工具
air_quickstart	根据当前环境状态提供个性化的 3 步设置指南
air_profile_get	读取共享的 Delx Wellness 档案（位置、敏感项、单位）
air_profile_update	将非机密补丁保存到共享健康档案（需要明确意图）
air_onboarding	共享健康档案的 11 个问题引导流程
air_demo	逼真的示例载荷——在配置任何内容之前预览输出
air_health_recommendation	PM2.5/CO₂/VOC → WHO/EPA 区间 + 通俗易懂的行动建议
air_health_bands	将 PM2.5/PM10/CO₂/VOC 归入 WHO 2021 / EPA / ASHRAE / UBA 区间 + 引用来源
air_trend	对 PM2.5/CO₂/VOC 进行窗口趋势分析（平均值/中位数/变化率/峰值）

为什么优先本地处理？

• 公共传感器无需任何身份验证。 AirGradient 提供开放的公共 API，只需传入 locationId。
• 自有传感器的令牌保留在你的设备上。 仅当你拥有传感器时，才设置 AIRGRADIENT_API_TOKEN。
• 不收集遥测数据。 wellness-air 不会主动向外连接。唯一的出站调用会发往你配置的提供商。
• 只读。 没有工具会修改上游的任何内容。（air_profile_update 只会写入你的本地共享健康档案，不会写入任何提供商，并且需要明确的用户意图。）

跨连接器切入点

有趣之处在于：将它与 Delx Wellness 生态中的其他部分配合使用。

WHOOP recovery 47   +   wellness-air AQI 132 (unhealthy_sensitive)
       ↓                          ↓
   Coach: "Recovery's low AND the bedroom AQI was unhealthy last night.
           Skip outdoor cardio today — try mobility + low-intensity strength indoors with HEPA running."

大多数 Agent 完全忽略了室内空气质量这一变量。wellness-air 弥补了这一缺口。

隐私

运行 wellness-air doctor 检查本地隐私状况。要点如下：

• 所有读数都缓存在 ~/.wellness-air 下（可配置）。
• 提供商令牌绝不会返回给 Agent。
• 不涉及生物特征数据——仅涉及环境数据。
• 工具输出会明确标记数据来源，以便下游审计。

路线图

已发布： AirGradient（公共 + 自有）· AirThings · PurpleAir 适配器 · WHO/EPA/ASHRAE/UBA 健康区间 · 窗口趋势分析（air_trend）· 共享 Delx Wellness 档案 + 引导流程。

接下来：

• IQAir AirVisual + Awair 适配器。
• 与 Delx Wellness 生态中其他部分进行交叉关联的辅助工具（例如 air_correlate_with_sleep）。
• AQI 阈值的 Webhook 触发器（当 AQI 超出某个区间时通知 Agent）。

📧 联系与支持

• 📨 [email protected] — 一般问题、集成帮助、合作事宜
• 🐛 Bug 报告 / 功能请求 — GitHub Issues
• 🐦 最新动态 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 参见 LICENSE。

_{wellness-air 是非官方连接器。AirGradient、AirThings、PurpleAir、IQAir 和 Awair 是其各自所有者的商标。这些公司均未与本项目建立关联，也未为本项目背书。}

Skill 还是 MCP

同一个包，两种接入方式。MCP 通过 stdio/HTTP 注册工具。如果客户端没有 MCP，skill 可以通过 CLI 调用相同的工具：

npx -y wellness-air call air_connection_status --json '{}'

将 skill/SKILL.md 复制到 Agent 技能目录。