Fulcra Context

🫀 AI 代理的健康数据情境中枢

通过 OAuth2 安全授权,让 AI 代理读取用户的生物特征、睡眠、活动、日历和位置等 188 项健康数据,实现个性化情境感知服务。

收藏
9.3k
安装
3.3k
版本
1.4.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Fulcra Context 是一款面向 AI 代理的健康数据读取技能,通过 Fulcra Life API、MCP 服务器或 CLI 工具,为代理提供用户授权的生物特征、睡眠、活动、日历、位置等全方位情境数据。

主要功能模块

  • 生物特征监测:心率、HRV、血压、血氧、呼吸频率等 188 项指标
  • 睡眠分析:睡眠阶段(REM/深睡/浅睡)、睡眠周期、效率评估
  • 活动追踪:步数、卡路里、运动时长、VO2Max、步行/跑步/骑行分析
  • 情境感知:实时位置、日历事件、环境音频、日照时间
  • 健康洞察:营养摄入、症状记录、生殖健康、实验室指标

三种接入方式

1. MCP 服务器(推荐)https://mcp.fulcradynamics.com/mcp,支持 Claude Desktop、Goose、Windsurf、VS Code
2. Fulcra CLI(Beta,适合自动化)uv tool run fulcra-api,支持设备授权流程,便于远程/服务器部署

3. Python 服务层:用于现有脚本集成,自动处理 CLI 凭证和 JSON 输出规范化

典型使用场景

  • 晨间简报:结合睡眠数据 + 日历 + 天气,调整信息推送强度
  • 压力感知沟通:监测 HRV 和心率,在高压时段简化消息、降低打扰
  • 主动恢复建议:高强度训练或劣质睡眠后,自动建议轻量日程和补水提醒
  • 旅行智能:位置变化时自动调整时区处理、提供本地化建议

显著优点

1. 隐私优先设计:OAuth2 逐用户授权,数据用户所有,随时可撤销,代理仅获委托访问
2. 企业级安全:令牌自动刷新、设备授权流程支持远程代理、CLI 凭证隔离存储

3. 数据丰富度:188 项指标覆盖心血管、呼吸、睡眠、运动、营养、生殖健康等全维度

4. 生产就绪工具链:内置睡眠阶段数学修正(UTC 日期处理)、时区自动管理、数据新鲜度监控、可视化图表生成

5. 生态开放:全开源 MCP 服务器、Python 客户端、详细开发者文档、活跃 Discord 社区

6. 边界清晰:与 fulcra-annotations 读写分离,读操作用本技能,写操作用配套技能

潜在缺点与局限性

1. iOS 生态依赖:数据主要来源于 Apple Watch/iPhone,Android 用户数据覆盖有限
2. 账户门槛:需下载 Context iOS App 或注册 Portal 账户,非即开即用

3. Beta CLI 阶段:CLI 工具标记为 Beta,命令集可能变动,自动化场景需关注兼容性

4. 同步延迟风险:Apple Watch 同步失败或 Fulcra 服务问题时,数据可能滞后(提供监控工具应对)

5. 地域限制:服务由 Fulcra Dynamics 提供,可能存在数据跨境合规考量

6. 学习曲线:188 项指标需要一定时间理解其临床意义和适用场景

适合人群

  • 健康科技开发者:构建个性化健康教练、智能助理、企业健康平台的团队
  • 量化自我爱好者:希望用 AI 分析自身健康数据、优化生活节奏的高级用户
  • 远程工作/数字游民:需要跨时区智能日程管理和身体状态感知的移动工作者
  • 运动康复人群:基于 HRV、睡眠、恢复指标调整训练强度的运动员
  • AI 代理开发者:为 Claude、Goose 等代理添加真实世界情境感知能力的构建者

常规风险

1. 隐私泄露风险:生物特征、位置、日历属于敏感数据,需严格遵循"绝不公开分享"原则,文档/截图使用合成数据
2. 授权凭证管理:CLI 凭证文件存储于 ~/.config/fulcra/,共享设备需确保文件权限正确

3. 健康建议边界:AI 基于数据提供的建议属参考性质,重大健康决策需咨询医疗专业人员

4. API 服务依赖:Fulcra 平台可用性影响数据获取,建议实现降级策略(如检测到数据陈旧时告警)

5. 时区/DST 处理:硬编码时区会导致错误,必须使用提供的 fulcra_timezone 工具处理夏令时

6. 睡眠数据计算陷阱:手动累加睡眠阶段会低估约 20%,必须使用 sleep_cycles.total_time_asleep_ms

Fulcra Context 内容

scripts文件夹
手动下载zip · 55.0 kB
calendar_vitals_chart.pytext/plain
请选择文件