名称： gevety
版本： 1.6.0
描述： 访问您的 Gevety 健康数据 - 生物标志物、健康寿命评分、生理年龄、补充剂、活动、每日行动、90天健康方案、即将进行的测试、实验室报告和健康内容
主页： https://gevety.com
user-invocable: true
command: gevety
元数据：
clawdbot:
primaryEnv: GEVETY_API_TOKEN
requires:
env:
- GEVETY_API_TOKEN

Gevety 健康助手

您可以通过 REST API 访问用户的 Gevety 健康数据。使用 web_fetch 来获取他们的生物标志物、健康寿命评分和可穿戴设备统计数据。

首次设置

如果是用户第一次使用 Gevety，请引导他们完成设置：

1. 获取 Gevety 账户：如果没有账户，请访问 https://gevety.com 注册。
2. 上传血液检测报告：需要上传实验室报告才能拥有生物标志物数据。
3. 生成 API 令牌：
   • 前往 https://gevety.com/settings
   • 点击 "Developer API" 标签页
   • 点击 "Generate Token"
   • 复制令牌（以 gvt_ 开头）
4. 配置 Clawdbot：将令牌添加到 ~/.clawdbot/clawdbot.json：

{
  "skills": {
    "entries": {
      "gevety": {
        "apiKey": "gvt_your_token_here"
      }
    }
  }
}

添加令牌后，需要重启 Clawdbot 才能使更改生效。

身份验证

所有请求都需要 Bearer 身份验证。使用 GEVETY_API_TOKEN 环境变量：

Authorization: Bearer $GEVETY_API_TOKEN

基础 URL：https://api.gevety.com

生物标志物名称处理

API 保留生物标志物的特异性。空腹和非空腹变体是独立的：

重要：API 不再强制假设空腹状态。如果实验室报告只说 "Glucose" 而未指定空腹，则返回为 "Glucose"（而非 "Fasting Glucose"）。这保留了您实验室结果的原始上下文。

可用端点

1. 列出可用数据（从此处开始）

始终首先调用此端点，以发现存在哪些健康数据。

GET /api/v1/mcp/tools/list_available_data

返回：
- biomarkers：跟踪的生物标志物列表，包含检测次数和最新日期
- wearables：连接的设备和可用指标
- insights：是否计算了健康寿命评分，轴分数是否可用
- data_coverage：跟踪的推荐生物标志物百分比 (0-100)

2. 获取健康摘要

用户健康状况概览。

GET /api/v1/mcp/tools/get_health_summary

返回：
- overall_score：健康寿命评分 (0-100)
- overall_status：OPTIMAL, GOOD, SUBOPTIMAL 或 NEEDS_ATTENTION
- trend：IMPROVING, STABLE 或 DECLINING
- axis_scores：各健康维度（代谢、心血管等）的分数
- top_concerns：需要关注的生物标志物
- scoring_note：当总体评分与轴分数不一致时的解释（例如，"总体健康寿命评分高，但炎症轴需要关注"）

关于评分的说明：总体健康寿命评分是加权综合评分。可能出现总体评分高但某一轴分数低的情况（反之亦然）。scoring_note 字段解释了这些情况。

3. 查询生物标志物

获取特定生物标志物的详细历史记录。

GET /api/v1/mcp/tools/query_biomarker?biomarker={name}&days={days}

参数：
- biomarker (必需)：名称或别名（例如 "vitamin d", "ldl", "hba1c", "crp"）
- days (可选)：历史周期，1-730，默认 365

返回：
- canonical_name：标准化的生物标志物名称（见上表）
- history：包含日期、数值、单位、标记的检测结果数组
- latest：最近一次结果
- trend：方向（IMPROVING, STABLE, DECLINING）和百分比变化
- optimal_range：基于证据的最佳值范围

提示：如果未找到生物标志物，响应会包含 did_you_mean 建议。

4. 获取可穿戴设备统计数据

来自连接的可穿戴设备（Garmin, Oura, Whoop 等）的每日指标。

GET /api/v1/mcp/tools/get_wearable_stats?days={days}&metric={metric}

参数：
- days (可选)：历史周期，1-90，默认 30
- metric (可选)：关注特定指标（steps, hrv, sleep 等）

返回：
- connected_sources：连接的可穿戴设备平台列表
- daily_metrics：每日数据（步数、静息心率、心率变异性、睡眠、恢复情况）
- summaries：汇总统计数据，包含平均值、最小值、最大值、趋势

5. 获取改善机会

获取按健康寿命影响估计排序的健康改善机会。

GET /api/v1/mcp/tools/get_opportunities?limit={limit}&axis={axis}

参数：
- limit (可选)：返回的最大机会数，1-50，默认 10
- axis (可选)：按健康轴筛选（metabolic, cardiovascular 等）

返回：
- opportunities：排序的改善机会列表
- total_opportunity_score：可用的总健康寿命分数
- total_years_estimate：如果全部优化后估计的健康寿命年数
- healthspan_score：当前健康寿命评分

每个机会包含：
- biomarker：标准化的生物标志物名称
- current_value / optimal_value：当前值 vs 目标值
- opportunity_score：优化后可获得的健康寿命分数
- years_estimate：估计可获得的健康寿命年数
- priority：排名（1 = 影响最大）

6. 获取生理年龄

使用经过验证的算法（PhenoAge, Light BioAge）计算生理年龄。

GET /api/v1/mcp/tools/get_biological_age

返回：
- result：生理年龄计算结果（如果可用）
- biological_age：计算出的生理年龄
- chronological_age：日历年龄
- age_acceleration：差异（正值 = 衰老更快）
- algorithm：使用的算法
- biomarkers_used：贡献的生物标志物
- interpretation：结果的含义
- available：计算是否可行
- reason：不可用的原因（如果适用）
- upgrade_available：是否可以通过更多数据解锁更好的算法
- upgrade_message：哪些额外的检测会有帮助

7. 列出补充剂

获取用户的补充剂方案。

GET /api/v1/mcp/tools/list_supplements?active_only={true|false}

参数：
- active_only (可选)：仅显示当前活跃的补充剂，默认 false

返回：
- supplements：补充剂列表，包含剂量、频率、持续时间
- active_count：当前活跃补充剂的数量
- total_count：跟踪的补充剂总数

每个补充剂包含：
- name：补充剂名称
- dose_text：格式化剂量（例如 "1000 mg daily", "200mg EPA + 100mg DHA daily"）
- is_active：当前是否正在服用
- duration_days：服用此补充剂的天数

注意：对于多组分补充剂（如鱼油），dose_text 会显示所有组分（例如 "200mg EPA + 100mg DHA daily"）。

8. 获取活动记录

从连接的可穿戴设备获取锻炼/活动历史记录。

GET /api/v1/mcp/tools/get_activities?days={days}&activity_type={type}

参数：
- days (可选)：历史周期，1-90，默认 30
- activity_type (可选)：按类型筛选（running, cycling, strength 等）

返回：
- activities：包含指标的锻炼列表
- total_count：活动数量
- total_duration_minutes：总锻炼时间
- total_distance_km：总覆盖距离
- total_calories：总消耗卡路里

每个活动包含：
- activity_type：类型（running, cycling, swimming 等）
- name：活动名称
- start_time：开始时间
- duration_minutes：持续时间
- distance_km：距离（如果适用）
- calories：消耗的卡路里
- avg_hr / max_hr：心率数据
- source：数据来源（garmin, strava 等）

9. 获取今日行动清单

获取用户今天的行动清单。

GET /api/v1/mcp/tools/get_today_actions?timezone={timezone}

参数：
- timezone (可选)：IANA 时区（例如 "America/New_York"），默认 UTC

返回：
- effective_date：用户时区中查询的日期
- timezone：用于计算的时区
- window_start / window_end：日边界（ISO 日期时间）
- actions：今日行动列表
- completed_count / total_count：完成统计
- completion_pct：数字完成百分比 (0-100)
- last_updated_at：缓存陈旧性指示器

每个行动包含：
- action_id：用于深度链接的稳定 ID
- title：行动标题
- action_type：类型（supplement, habit, diet, medication, test, procedure）
- completed：今日是否已完成
- scheduled_window：时间窗口（morning, afternoon, evening, any）
- dose_text：剂量信息（如果适用，例如 "1000 mg daily"）

10. 获取健康方案

获取用户的 90 天健康方案及首要优先级。

GET /api/v1/mcp/tools/get_protocol

返回：
- protocol_id：稳定的方案 ID
- phase：当前阶段（week1, month1, month3）
- days_remaining：方案到期前的天数
- generated_at / last_updated_at：时间戳
- top_priorities：前 5 项健康优先级及原因
- key_recommendations：饮食和生活方式行动项
- total_actions：方案中的总行动数

每个优先级包含：
- priority_id：稳定 ID（与排名相同）
- rank：优先级排名（1 = 最高）
- biomarker：标准化的生物标志物名称
- status：当前状态（critical, concerning, suboptimal, optimal）
- target：目标值及单位
- current_value / unit：当前测量值
- measured_at：上次测量此生物标志物的时间
- why_prioritized：解释为何将此列为优先项

注意：如果不存在方案，则返回一个有用的错误，并建议在 gevety.com/protocol 生成一个。

11. 获取即将进行的测试

获取基于生物标志物历史和 AI 推荐，到期或推荐的测试。

GET /api/v1/mcp/tools/get_upcoming_tests

返回：
- tests：按紧急程度排序的即将进行测试列表
- overdue_count：过期测试数量
- due_soon_count：30 天内到期的测试
- recommended_count：AI 推荐的测试
- total_count：即将进行测试的总数

每个测试包含：
- test_id：用于深度链接的稳定 ID（格式：panel_{id} 或 recommended_{id}）
- name：测试或组合名称
- test_type：类型（panel, biomarker, recommended）
- urgency：优先级级别（overdue, due_soon, recommended）
- due_reason：为何需要此测试（例如 "Due 2 weeks ago", "AI recommendation"）
- last_tested_at：上次测试时间（如果适用）
- biomarkers：包含的生物标志物列表（针对组合）

12. 列出检测结果

获取已上传的实验室报告列表，包含日期、来源和生物标志物数量。

GET /api/v1/mcp/tools/list_test_results?limit={limit}&start_date={date}&end_date={date}

参数：
- limit (可选)：返回的最大报告数，1-50，默认 10
- start_date (可选)：筛选开始日期 (YYYY-MM-DD)
- end_date (可选)：筛选结束日期 (YYYY-MM-DD)

返回：
- reports：实验室报告列表
- total_reports：报告总数

每个报告包含：
- report_id：稳定的报告 ID
- report_date：实验室检测日期
- source：上传方式（pdf, email, manual）
- lab_name：实验室名称（如果可用）
- biomarker_count：此报告中的生物标志物数量
- filename：原始文件名（如果以 PDF 上传）

13. 列出所有生物标志物

一次性获取所有跟踪的生物标志物，包含当前值、状态分类和趋势。

GET /api/v1/mcp/tools/list_all_biomarkers?category={category}&status={status}

参数：
- category (可选)：按类别筛选（例如 "metabolic", "cardiovascular"）
- status (可选)：按状态筛选（optimal, suboptimal, high, low, critical_high, critical_low）

返回：
- biomarkers：包含最新值的所有生物标志物列表
- total_count：生物标志物总数
- counts_by_status：按状态细分（optimal, suboptimal, high, low, critical_high, critical_low, unknown）

每个生物标志物包含：
- name：标准化的生物标志物名称
- category：健康类别（metabolic, cardiovascular 等）
- latest_value：最近一次检测值
- unit：测量单位
- status：分类（optimal, suboptimal, high, low, critical_high, critical_low, unknown）
- last_test_date：上次检测时间
- trend_direction：自上次检测以来的趋势（increasing, decreasing, stable）

14. 获取内容推荐

根据生物标志物档案获取个性化的健康内容推荐。

GET /api/v1/mcp/tools/get_content_recommendations?limit={limit}&category={category}

参数：
- limit (可选)：最大推荐数，1-20，默认 5
- category (可选)：按内容类别筛选

返回：
- recommendations：推荐文章列表
- total_available：可用推荐总数

每个推荐包含：
- content_id：稳定的内容 ID
- title：文章标题
- summary：简要摘要
- category：内容类别
- relevance_reason：为何与用户相关
- quality_score：证据质量评分（仅显示高质量内容）
- url：文章链接

解读评分

健康寿命评分 (0-100)

轴评分

每个健康维度独立评分：
- 代谢：血糖、胰岛素、血脂
- 心血管：心脏健康标志物
- 炎症：hs-CRP、同型半胱氨酸
- 激素：甲状腺、睾酮、皮质醇
- 营养：维生素、矿物质
- 肝/肾：器官功能标志物

重要：可能出现总体评分高但某一轴分数低的情况（反之亦然）。get_health_summary 中的 scoring_note 字段解释了这些情况。

生物标志物状态标签

常见工作流程

"我最近怎么样？"

1. 调用 list_available_data 查看跟踪了哪些数据
2. 调用 get_health_summary 获取整体情况
3. 突出显示首要关注点和近期趋势
4. 如果存在 scoring_note，解释评分不一致的原因

"告诉我我的维生素 D 情况"

1. 调用 query_biomarker?biomarker=vitamin d
2. 展示历史记录、当前状态和趋势
3. 指出最佳范围与当前值的