wellness-air

Wellness Air

AI エージェント向けのローカルファーストな空気質 MCP。
AirGradient／AirThings／PurpleAir センサーをエージェントに接続できます — トークンがマシンの外に出ることはありません。

📡 開発の背景：睡眠／集中力／トレーニングの成果は、ある程度部屋の環境にも左右されます。PM2.5 が 35 を超える、CO₂ が 1,000 ppm を超える、湿度が低い — こうした要因は回復を損ない、エージェントにも検知できません。wellness-air は、あらゆる AI エージェントにローカルファーストな環境コンテキストを提供し、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 対応 AI エージェントに公開するローカル MCP サーバーです。AirGradient を標準でサポートしています（オープンハードウェアと無料の公開 API — 世界中のフィードにある 2,000 台以上の公開センサーで認証は不要です）。AirThings と PurpleAir も実装済みです（無料の API 認証情報はご自身で用意してください）。IQAir AirVisual と Awair はロードマップに含まれています。

wellness-air がエージェントに役立ったら、ぜひリポジトリにスターを付けてください。スターが増えると、ほかの 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"
      }
    }
  }
}

クライアントを再読み込みしてください。これでエージェントが 19 個の空気質ツールを利用できるようになります。

ツール（合計19個）

ツール	目的
air_agent_manifest	ランタイム契約：ツール一覧、対応クライアント、環境変数、推奨される最初の呼び出し
air_capabilities	対応プロバイダー、設定済みプロバイダー、利用可能な指標、プライバシーモード
air_connection_status	ヘルスチェックと、エージェントが提示すべき警告
air_privacy_audit	ローカルに記録されるデータとプロバイダーに送信されるデータ
air_data_inventory	指標カタログとAQI区分のしきい値
air_current_reading	最新のセンサー測定値（PM2.5、CO₂、AQI、気温、湿度）
air_list_devices	認証済みプロバイダーアカウント（AirThings）のデバイス一覧
air_aqi_check	区分と推奨事項を含む「空気の状態は良好か？」への簡潔な回答
air_daily_summary	1日の状況をまとめたスナップショット
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."

ほとんどのエージェントは、室内の空気質という要素を完全に見落としています。wellness-airがその不足を補います。

プライバシー

wellness-air doctorを実行すると、ローカルのプライバシー設定を確認できます。主な特長：

• すべての測定値は~/.wellness-air以下にキャッシュされます（設定変更可能）。
• プロバイダーのトークンがエージェントに返されることはありません。
• 生体データは扱いません — 環境データのみです。
• 下流で監査できるよう、ツールの出力にはデータソースが明示的にタグ付けされます。

ロードマップ

リリース済み： AirGradient（公開版＋所有センサー）· AirThings · PurpleAirアダプター · WHO／EPA／ASHRAE／UBAの健康区分 · 期間指定トレンド分析（air_trend）· 共有Delx Wellnessプロファイル＋オンボーディング。

次の予定：

• IQAir AirVisualおよびAwairアダプター。
• Delx Wellnessスタックのほかの要素と照合する、相互相関ヘルパー（例：air_correlate_with_sleep）。
• AQIしきい値に対するWebhookトリガー（AQIが区分を超えたときにエージェントへ通知）。

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的なご質問、統合サポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — Xの@delx369
• 🌐 サイト — wellness.delx.ai

ライセンス

MIT — LICENSEを参照してください。

_{wellness-airは非公式のコネクターです。AirGradient、AirThings、PurpleAir、IQAir、Awairは、それぞれの所有者の商標です。これらの企業はいずれも、本プロジェクトと提携しておらず、推奨もしていません。}

スキルまたは MCP

同じパッケージに、2 つの利用方法があります。MCP は stdio/HTTP 経由でツールを登録します。スキルを使うと、クライアントが MCP に対応していない場合でも、CLI 経由で同じツールを利用できます：

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

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。