wellness-cycle-coach

Wellness Cycle Coach

AI エージェント向けの月経周期コーチ MCP — PCOS 対応モードを搭載しました。
エージェントが見過ごしてきたユーザーの50％にも、AI の恩恵が届くように構築されています — 周期データを保存することは一切ありません。

🌙 開発の理由：ほとんどの AI エージェントは、身体を文脈に左右されない一つの単位として扱います。しかし、エネルギー、回復、トレーニングへの耐性、栄養の必要量、さらには認知能力も、月経周期に合わせて変化します。wellness-cycle-coach は、あらゆるエージェントに周期に応じたガイダンスを提供します — そのために周期データを保存することは一切ありません。

⚡ ワンコマンドでインストール — 使用するランタイムを選択してください：

• Delx Wellness for Hermes：npx -y delx-wellness-hermes setup
• Delx Wellness for OpenClaw：npx -y delx-wellness-openclaw setup

---

HTTP（v2 ステートレス）

デフォルトは stdio です。オプションで Streamable HTTP を利用できます — セッション ID なし、JSON レスポンス、ループバックのみ：

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

環境変数：WELLNESS_CYCLE_COACH_HOST、WELLNESS_CYCLE_COACH_PORT、WELLNESS_CYCLE_COACH_TRANSPORT=http。

概要

月経開始日を渡すと（Apple Health Cycle、Garmin women's health、Fitbit female health、またはユーザーからの直接入力など、取得元は問いません）、ユーザーの現在のフェーズと、栄養、トレーニング、水分補給に関するフェーズ別の推奨事項を返します。ステートレス — MCP 自体が周期データを永続化することはありません。cycle_irregular フラグによる PCOS 対応モードをサポート（v0.3.3） — 21～90日の周期を受け入れ、信頼度を「低」に制限し、標準的な14日間の黄体期の計算が当てはまらない場合は luteal_extended のプレースホルダーを返します。

60秒で試す

npx -y wellness-cycle-coach doctor

# Or use the MCP directly via your client:
# {
#   "mcpServers": {
#     "wellness-cycle-coach": {
#       "command": "npx",
#       "args": ["-y", "wellness-cycle-coach"]
#     }
#   }
# }

次に、エージェントで以下を実行します：

{
  "name": "cycle_full_report",
  "arguments": {
    "history": [
      { "start_date": "2026-04-01" },
      { "start_date": "2026-04-29" }
    ]
  }
}

現在のフェーズに加え、栄養面で重視するもの・適度に摂取するもの・避けるもの、トレーニングのスタイルと強度、水分補給の目標、次回の月経開始日の推定値を返します。

ツール（17）

ツール	目的
cycle_agent_manifest	実行時の契約
cycle_capabilities	フェーズ、上流コネクター、指標
cycle_connection_status	ヘルス状態＋ステートレスであることのリマインダー
cycle_privacy_audit	ログに記録される内容（なし）と外部に送信される内容（なし）
cycle_data_inventory	フェーズ分類＋指標カタログ
cycle_estimate_phase	現在のフェーズ＋周期日＋信頼度
cycle_predict_next_period	平均周期日数＋次回月経日
cycle_phase_guidance	特定のフェーズに応じた推奨事項
cycle_recommend_nutrition	現在のフェーズに応じた栄養の推奨事項
cycle_recommend_training	現在のフェーズに応じたトレーニングの推奨事項
cycle_full_report	1回の呼び出しで得られる総合レポート
cycle_irregular_check	履歴に基づくPCOS／不規則な周期のスクリーニング
cycle_quickstart	最小限のスタートガイド
cycle_profile_get	共有Delx Wellnessプロファイルの読み取り（読み取り専用）
cycle_profile_update	オプトインしたプロファイル設定の保存（ユーザーの明示的な意思表示が必要）
cycle_onboarding	共有プロファイル用の11問のオンボーディングフロー
cycle_demo	手軽に試すためのサンプルリクエスト／レスポンス

4フェーズモデル

フェーズ	時期	活力	栄養の重点	トレーニング
月経期	1日目から月経終了まで（約5日）	低下	鉄＋マグネシウム＋オメガ3	回復重視（ヨガ、ウォーキング、モビリティ）
卵胞期	月経後から排卵の2日前まで	上昇／ピーク	複合炭水化物＋低脂肪タンパク質＋発酵食品	強化（筋力トレーニング、スプリント、新しいスキル）
排卵期	排卵日の前後1日	ピーク	抗酸化物質＋亜鉛	ピーク（自己ベスト更新、プライオメトリクス）
黄体期	排卵の2日後から次回月経まで	低下	ビタミンB群＋マグネシウム＋複合炭水化物	持久力＋技術

なぜステートレスなのか？

月経周期のデータは医療記録と同等に機微な情報です。最も強力なプライバシー保護は、決して保存しないことです。FloやClueなどの他のアプリは、サーバー上に周期データを大量に蓄積して運営されていますが、このMCPはそれに加担しません。エージェントがデータを渡し、コーチがガイダンスを返すと、データは消去されます。

コネクター横断の強み

Apple Health Cycle → period dates       ┐
Garmin women's health → cycle context   ├─→ wellness-cycle-coach → phase + guidance
Fitbit female health → period dates     ┘                                  │
                                                                            │
                                                                            ↓
                                                            wellness-nourish coach
                                                            (phase-aware meal planning)
                                                                            │
                                                            whoop-mcp / garminmcp / ouramcp
                                                            (recovery-aware late-luteal load adjustments)

プライバシー

• ✅ 周期データはステートレス — 月経日は決して永続化されません。呼び出しの間だけプロセスメモリに保持され、その後消去されます。
• ✅ オプトインによるローカル設定 — cycle_profile_* ツールは、秘密情報を含まないウェルネス設定（名前、目標、デバイス、トレーニング／栄養のコンテキスト）を ~/.delx-wellness/profile.json に永続化できますが、ユーザーが明示的に要求した場合に限ります（cycle_profile_update には explicit_user_intent: true が必要です）。秘密情報（トークン、APIキー、バイオマーカー）は書き込み時に拒否されます。
• ✅ オフラインで利用可能 — 純粋関数による計算です。外部への呼び出しはありません。
• ✅ ツール引数のみで扱う周期データ — エージェントはMCPリクエスト経由で月経履歴を渡し、データはプロセスメモリに保持されます。

wellness-cycle-coach doctor を実行して確認してください。

このツールにできないこと

• 医療上の助言や診断ではありません。
• 妊活トラッカーや避妊の補助ツールではありません（医療従事者に相談してください）。
• 痛みを伴う月経、異常な月経、月経がない場合に、医療従事者へ相談する代わりにはなりません。
• cycle_irregular: true によるPCOS／不規則な周期に対応しています（v0.3.3）が、臨床ケアの代わりにはなりません。妊孕性、避妊、症状管理について判断する際は、医療従事者に相談してください。
• 周閉経期やピル中止後に特化したものではありません（現時点では未対応です。CONTRIBUTING.mdを参照してください）。

ロードマップ

• v0.2 — apple-health-mcp／garminmcp／fitbitmcp用のアダプターを追加し、エージェントが1回のMCP呼び出しで月経履歴を取得できるようにします。
• v0.3 — 症状記録機能と、症状に応じたガイダンスの調整（けいれん痛にはマグネシウムを重視、気分の落ち込みにはビタミンB群を重視）を追加します。
• v0.4 — pt-BRから非英語ロケールのサポートを開始します。

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

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

ライセンス

MIT — LICENSEをご覧ください。

_{wellness-cycle-coach は独立した研究用ソフトウェアです。Clue、Flo、Stardust、その他の生理周期トラッキングアプリとは無関係です。医療上のアドバイスではありません。}

スキルまたは MCP

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

npx -y wellness-cycle-coach call cycle_connection_status --json '{}'

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