wellness-cycle-coach

健康周期教练

面向 AI Agent 的月经周期教练 MCP——现已支持 PCOS 感知模式。
专为 AI 终于能服务于被 Agent 忽视的50% 用户而打造——且从不存储周期数据。

🌙 为什么要打造它：大多数 AI Agent 都把身体视作一个不考虑上下文的整体。但精力、恢复、训练耐受度、营养需求，甚至认知带宽，都会随着月经周期而变化。wellness-cycle-coach 为任何 Agent 提供感知周期阶段的指导——而且从不为此存储周期数据。

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

• 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"]
#     }
#   }
# }

然后在你的 Agent 中：

{
  "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	一次调用生成综合报告
cycle_irregular_check	根据历史记录筛查 PCOS / 月经周期不规律
cycle_quickstart	简明入门指南
cycle_profile_get	读取共享的 Delx Wellness 个人资料（只读）
cycle_profile_update	保存用户选择加入的个人资料偏好（需要明确的用户意图）
cycle_onboarding	共享个人资料的 11 个问题入门流程
cycle_demo	用于快速探索的示例请求/响应

4 阶段模型

阶段	时间	精力	营养重点	训练
menstrual	第 1 天 → 月经结束（约 5 天）	较低	铁 + 镁 + Omega-3	恢复性训练（瑜伽、步行、灵活性练习）
follicular	月经结束后 → 排卵前 2 天	逐渐提升 / 达到峰值	复合碳水化合物 + 瘦蛋白 + 发酵食品	增强（力量训练、冲刺、新技能）
ovulatory	排卵前后 ± 1 天	峰值	抗氧化剂 + 锌	峰值训练（个人纪录、增强式训练）
luteal	排卵后第 2 天 → 下次月经	逐渐下降	B 族维生素 + 镁 + 复合碳水化合物	耐力 + 技术

为什么采用无状态设计？

月经周期数据属于医疗记录敏感信息。最有力的隐私保障就是永远不存储这些数据。其他应用（Flo、Clue）靠在服务器上囤积周期数据维持运营；这个 MCP 拒绝参与。Agent 传入数据，教练返回建议，数据随即消失。

跨连接器优势

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 密钥、生物标志物）。
• ✅ 支持离线使用 — 纯函数计算。不进行任何外部调用。
• ✅ 周期数据仅通过工具参数传递 — Agent 通过 MCP 请求传入月经历史，数据仅保留于进程内存中。

运行 wellness-cycle-coach doctor 进行检查。

本工具不是什么

• 不是医疗建议或诊断。
• 不是生育跟踪器或避孕辅助工具（请咨询临床医生）。
• 不能替代就疼痛、异常或未出现的月经咨询医疗服务提供者。
• 支持通过 cycle_irregular: true 检查 PCOS / 月经周期不规律（v0.3.3），但不能替代临床护理 — 生育、避孕或症状管理方面的决策请咨询临床医生。
• 目前尚未针对围绝经期或停用避孕药后的情况专门优化 — 参见 CONTRIBUTING.md。

路线图

• v0.2 — 为 apple-health-mcp / garminmcp / fitbitmcp 添加适配器，让 Agent 通过一次 MCP 调用即可获取月经历史。
• v0.3 — 添加症状记录功能和症状适配建议调整（痉挛 → 加强镁摄入建议，情绪低落 → 加强 B 族维生素摄入建议）。
• v0.4 — 增加非英语区域设置支持，首先支持 pt-BR。

📧 联系与支持

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

许可证

MIT — 详见 LICENSE。

_{wellness-cycle-coach 是独立的研究软件。与 Clue、Flo、Stardust 或任何其他周期追踪应用均无关联。内容不构成医疗建议。}

Skill 或 MCP

同一软件包，两种使用方式。MCP 通过 stdio/HTTP 注册工具。skill 可在客户端不支持 MCP 时，通过 CLI 调用相同的工具：

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

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