Fulcra Context

🫀 你的健康数据,Agent 的上下文感知力

安全读取用户授权的生物识别、睡眠、活动、日历等健康数据,支持 MCP/CLI/Python 三种接入方式,188 项指标全覆盖,助力 AI Agent 实现情境感知与个性化服务。

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

使用说明

Fulcra Context 深度评估

核心用法

Fulcra Context 是一款面向 AI Agent 的生物识别与健康数据读取技能,通过 OAuth2 授权模型 让用户完全掌控数据访问范围。技能提供三种主要接入方式:

1. MCP Server(推荐)https://mcp.fulcradynamics.com/mcp,支持 Claude Desktop、ChatGPT、Codex 等主流 Agent 平台
2. Fulcra CLI(自动化首选)uv tool run fulcra-api,适合定时任务与脚本化工作流

3. Python Service Layer:面向现有代码库的适配层

核心数据类型覆盖 188 项健康指标,包括:心血管(心率、HRV、血压)、呼吸(血氧、呼吸率)、睡眠(分期、效率)、活动(步数、消耗、运动)、营养、生殖健康等十余个类别。典型查询场景包括:获取昨夜睡眠质量、监测心率变异性趋势、读取日历事件、追踪地理位置上下文等。

显著优点

隐私架构领先:用户数据始终归用户所有,Fulcra 仅提供存储与委托访问,可随时撤销授权。这种设计避免了传统健康 API 的"数据托管"风险,符合 GDPR 和个人数据主权趋势。

生态兼容性强:已验证兼容 Hermes、Claude Desktop、Goose、Windsurf、VS Code 等主流 Agent 环境;开源 MCP 实现(github.com/fulcradynamics/fulcra-context-mcp)支持社区审计与扩展。

指标覆盖全面:188 项指标远超 Apple HealthKit 公开接口,包含 AFib 负荷、睡眠呼吸暂停事件、VO2Max、六分钟步行距离等临床级数据,支持从消费级健康追踪到轻度医疗监测的广泛场景。

工程细节成熟:内置时区自动处理(UTC↔本地)、睡眠阶段算法校正(修正 Apple Health 的 20% 低估问题)、数据新鲜度监控(Cron 就绪的看门狗脚本)、以及符合 DST 规范的 ZoneInfo 实现。

配套工具完善:提供 fulcra-annotations 姐妹技能用于双向数据写入,支持主观评分、事件标记与 LLM 生成的记忆回写,形成"读取-分析-反馈"闭环。

潜在缺点与局限性

平台依赖风险:核心数据源(Apple Watch、iOS Health)绑定苹果生态,Android 支持"即将到来",跨平台用户可能面临数据断层。

学习曲线陡峭:188 项指标的语义差异(如 SleepStage 的 0-4 编码 vs. sleep_cycles.total_time_asleep_ms 的权威时长)需要仔细阅读文档;CLI 的 jq 管道与 Python service 的并存增加了选型困惑。

网络与同步延迟:生物识别数据依赖 Apple Watch → iPhone → Fulcra 云的三级同步,实测可能出现 12 小时以上的延迟(技能内置 fulcra_data_watchdog 检测此类问题)。

OAuth2 的 UX 摩擦:远程 Agent 场景下的设备授权流程(device URL + user code)需要用户离开聊天界面完成验证,对"纯对话式"Agent 体验有一定破坏。

无本地 LLM 集成:技能本身不调用大模型,所有"情境感知简报"需在 Agent 运行时自行实现,对开发者的 Prompt 工程能力有要求。

适合人群

  • 健康科技开发者:构建个性化健康教练、恢复管理系统、或慢性病患者监测工具
  • 效率工具产品经理:开发"情境感知日程助理"——根据睡眠质量和 HRV 自动调整会议提醒强度
  • 量化自我(Quantified Self)爱好者:打通多源可穿戴数据,进行深度相关性分析
  • AI Agent 架构师:需要真实世界上下文(location + calendar + biometrics)来驱动 Agent 决策
  • 隐私敏感型用户:拒绝将健康数据托管给大型云平台,偏好 OAuth2 + 用户所有权的模式

常规风险

数据过度暴露:虽然 OAuth2 支持细粒度授权,但新手用户可能在授权时勾选全部 188 项指标,导致 Agent 获得超出其功能必要范围的数据。建议实施"最小权限原则"——仅请求场景所需的指标类别。

合成数据与真实数据混用:技能文档明确警告"不要将真实生物识别数据与虚假日历数据混合",但在实际开发中,测试/fixture 数据与生产数据的隔离需要开发者自律。

授权令牌泄露:CLI 将凭证存储于 ~/.config/fulcra/credentials.json,多用户服务器部署时需确保文件权限隔离;技能明确禁止在聊天中传输 access token、refresh token 或 Magic Links。

健康建议的法律边界:技能提供生物识别数据读取,但不提供医疗诊断。基于 HRV 或睡眠数据生成的建议需标注"仅供参考,不构成医疗建议",避免非专业健康指导的合规风险。

API 稳定性:CLI 标注为 Beta 阶段,fulcra-api 的命令集可能随版本迭代调整;生产部署建议锁定 uv 工具的版本或维护本地镜像。

Fulcra Context 内容

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