用途 HealthEx 用于通过 HealthEx MCP 服务器查询患者健康记录,把个人医疗数据接入对话,用于解答用药、检验结果、诊断与健康史相关问题,并为饮食计划、健身计划、就诊准备、旅行健康需求、睡眠与压力优化等场景提供健康背景信息。
主要能力
- 支持的数据类别:疾病(conditions)、用药(medications)、过敏(allergies)、检验结果(labs)、生命体征(vitals)、免疫接种(immunizations)、手术(procedures)、就诊(visits/encounters)、临床笔记(clinical notes)以及健康摘要(health summary)。
- 命令接口:通过 $JARVIS_BIN_DIR/healthex 调用,提供 status(检查连接状态)、setup(写入启用 PKCE 的 OAuth 默认配置)、disconnect(删除已存凭证与令牌)、authorize-url(生成 PKCE 授权链接)、refresh(刷新访问令牌)、mcp-list(列出可用 MCP 工具)、mcp-call(调用指定 MCP 工具)等子命令,输出均为 JSON。
- 连接守卫:任何数据访问前先运行 status,未连接则生成授权链接并以 Connect HealthEx 形式呈现,同时说明连接对象、只读权限范围、访问持续到用户在 HealthEx 账户撤销、数据用途等同意信息;回调完成后再检查 status。
- 数据检索策略:先按问题类型调用分类工具获取概览,再按用户意图做针对性拉取(如检验结果问题用 get_labs,用药问题用 get_medications 并结合 get_conditions、get_allergies;就诊准备用 get_labs、get_medications、get_vitals、get_conditions 等)。必要时用 mcp-list 发现工具及参数模式。
- 临床洞察模式:护理缺口检测(检验过期、就诊间隔、免疫缺口、筛查缺口)、疾病—用药—检验交叉对照、结合用户实际健康档案的饮食/运动/就诊准备建议、多风险因素聚合提示。
- 分页处理:检查响应中的分页信息,按需用 beforeDate 与 years 翻页;以连续两个空窗口或 10 次调用上限作为停止条件,并如实说明覆盖范围。
- 降级与安全:处理慢调用/后台进程句柄时轮询至完成或回退到分类工具;无真实数据(空结果、占位符、运行中句柄、失败)时明确告知数据不可用并给出下一步,绝不编造临床数值。
使用方式
- 运行 healthex status 检查连接状态。
- 若未连接,运行 healthex authorize-url 获取链接,向用户展示 Connect HealthEx 及同意说明。
- 回调完成后再次运行 status,确认 connected 后开始数据访问。
- 根据用户问题选择分类工具,通过 mcp-call --tool <name> [--args '<json>'] 拉取数据;需要时用 mcp-list 查看工具列表。
- 整理结果时基于实际返回数据作答,注明来源(如“基于你的 HealthEx 记录”),对护理缺口或风险给出具体下一步;不提供医学诊断、治疗建议或临床解释,建议用户咨询其医疗提供者。
适用场景 解答用药、检验结果、诊断与健康史问题;生成结合个人健康状况的饮食或运动计划;就诊前准备;旅行健康需求;筛查与免疫更新检查;识别可能与医生讨论的护理缺口。
限制
- 仅读取已连接提供方的记录,数据可能不完整或存在延迟;单来源数据需注明来源,缺失类别需说明缺口。
- get_health_summary 为较慢的聚合工具,可能被后台化,不宜作为唯一上下文来源。
- 不输出访问令牌或刷新令牌,不在当前请求之外保留健康数据。
- 不做医学诊断或治疗推荐;无真实数据时不推测、不编造数值或解读。
- 关于定价、平台支持范围等细节,资料暂未提供。