P3-随访沟通域-家庭
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"CKDNutri-care-mcp": {
"args": [
"CKDNutri-care-mcp"
],
"command": "uvx"
}
}
}
该服务需要配置环境变量:A207_CALLER、A207_DATA_DIR、A207_ENV、A207_OTS_ACCESS_KEY_ID、A207_OTS_ACCESS_KEY_SECRET、A207_OTS_ENDPOINT、A207_OTS_INSTANCE_NAME
可用工具 (10 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
schedule_followup_tool 7 个参数 需填 5 项
创建随访计划(按 CKD 分期自动算 next_due)。CKD 临床助手独占。 ckd_stage: G1/G2/G3a/G3b/G4/G5/G5D(KDIGO 2024 儿童分期); albuminuria_stage: A1/A2/A3;visit_type: outpatient/phone/online/dialysis/ nutrition_counsel(LLM 勿用 routine/first_visit 等非标准值)。
必填参数:patient_id、ckd_stage、albuminuria_stage、visit_type、visit_date
get_followup_records_tool 4 个参数 需填 1 项
查随访历史(含计划 + 下次到期日)。按身份视图裁剪;家长需携带 guardian_token。 limit/offset(L-3,2026-08-16):按 visit_date 升序分页——随访记录随年限增长, limit 缺省返回全量(向后兼容),长病史建议传 limit 控制上下文;返回 total/ truncated 供调用方翻页。
必填参数:patient_id
add_followup_record_tool 7 个参数 需填 4 项
记录一次实际完成的就诊随访(写,仅 CKD 临床助手)。 visit_type: outpatient/phone/online/dialysis/nutrition_counsel; ckd_stage: G1/G2/G3a/G3b/G4/G5/G5D; indicators_snapshot: 本次就诊检验指标快照(如 {egfr, k_mmol_L, ...}),供后续评估对照。
必填参数:patient_id、visit_date、visit_type、ckd_stage
get_adherence_score_tool 5 个参数 需填 4 项
计算并落库依从性评分。仅 CKD 临床助手可写。 weights: 自定义权重列表 [diet, medication, visit](三项之和应为 1),默认等权 1/3; 仅传数值(int/float),不得含 bool/NaN/Inf。
必填参数:patient_id、diet_ratio、med_ratio、visit_ratio
get_pew_timeline_tool 3 个参数 需填 1 项
查询 PEW 历史,与随访时间线合并展示。家长需携带 guardian_token。 pew_history: PEW 评估记录对象数组(每个元素为 {date, level, ...} 对象)。
必填参数:patient_id
get_notifications_tool 7 个参数 需填 1 项
查通知列表。status 按已读(all/unacked/acked);workflow_status 按闭环状态 (all/unacked/confirmed/resolved/closed);escalated 按升级布尔过滤 (升级与 workflow_status 正交);家长需携带 guardian_token。 page/page_size(P2 修复 2026-08-13):可选分页——page=None 返回全量(兼容), 传 page 则分页(page_size 默认 50、上限 200 钳制),避免通知多时灌爆上下文。
必填参数:patient_id
ack_notification_tool 2 个参数 需填 1 项
确认通知(幂等)。家长需携带 guardian_token 且与通知所属患者绑定。
必填参数:notification_id
trigger_event_notification_tool 3 个参数 需填 2 项
事件触发的通知创建:事件类型→模板填充→落库→推送 一键完成(DAG)。 event_type: followup_due / risk_escalation / report_ready。 payload 按事件类型填字段(须为对象 dict): - followup_due: {next_due_date(, due_at)} - risk_escalation: {from_level, to_level, rule} - report_ready: {}(无需额外字段)
必填参数:event_type、patient_id
update_notification_status_tool 3 个参数 需填 2 项
推移风险闭环状态机。仅 CKD 临床助手。 new_status: unacked → confirmed → resolved → closed(严格一步流转,禁止跳级); 目标为 resolved 时必须携带 resolution_note。已读确认请用 ack_notification_tool (只置 status=acked,不影响 workflow_status)。
必填参数:notification_id、new_status
escalate_notification_tool 2 个参数 需填 1 项
标记通知升级(24h 未确认自动升级 / 临床主动升级)。仅 CKD 临床助手。 升级后 workflow_status 保持原值(unacked/confirmed 皆可被升级),不丢失升级前状态。
必填参数:notification_id
服务介绍
测试用
家庭端