HRT PK MCP
激素替代治疗 (HRT) 药代动力学血药浓度监测 MCP 工具
Agent 可通过工具记录给药时间，并随时查询根据 PK 算法拟合的血药浓度
参考 HRT-Recorder-PKcomponent-Test 算法与数据拟合实现
支持雌二醇 (Estradiol) 和睾酮 (Testosterone) 的多种给药途径
快速开始
git clone https://github.com/lfcypo/hrt-pk-mcp
uv sync
uv run hrt-pk-mcp
# 或
python -m pk_mcp
MCP 工具
| 工具 | 说明 |
|---|---|
log_dose |
记录一次给药事件 |
query_concentration |
查询指定时间点的预测血药浓度 |
list_dose_events |
列出所有已记录的给药事件 |
remove_event |
按 ID 删除指定事件 |
clear_all_events |
清空所有给药事件 |
log_dose 记录一次给药事件
记录一次激素用药事件。每个事件会被持久化存储，并在后续所有浓度查询中纳入计算。
| 参数 | 类型 | 说明 |
|---|---|---|
compound |
str | 药物化合物：E2, EB, EV, EC, EN, T, TC, TE, TU |
route |
str | 给药途径：injection, gel, patch_apply, patch_remove, oral, sublingual |
time_h |
float | 给药时间 (距参考起点的小时数) |
dose_mg |
float | 剂量（活性激素当量, 毫克） |
release_rate_ug_per_day |
float? | 贴片零阶释放速率（µg/d），仅 patch_apply 使用 |
area_cm2 |
float? | 凝胶涂抹面积（cm²），仅 gel 使用 |
sublingual_theta |
float? | 舌下含服中经黏膜快通路吸收比例 [0-1]，仅 sublingual 使用 |
query_concentration 查询指定时间点的预测血药浓度
| 参数 | 类型 | 说明 |
|---|---|---|
time_h |
float | 查询时间点（距参考起点的小时数） |
hormone |
str | 目标激素：estradiol 或 testosterone |
body_weight_kg |
float | 体重（kg，默认 70.0；影响分布体积 Vd） |
数据存储
给药事件以 JSON 格式持久化存储在项目目录下的 .hrt-pk-data/dose_events.json 文件中
可跨会话检查、备份或迁移
药代动力学算法
本项目药代动力学算法与常数参考自 HRT-Recorder-PKcomponent-Test
关于详细的PK算法、完整参数推导、校准来源等，请参阅 HRT-Recorder与 pk_research
支持的化合物与给药途径
雌二醇 (Estradiol)
| 化合物 | 注射 | 口服 | 舌下 | 凝胶 | 贴片 |
|---|---|---|---|---|---|
| E2（雌二醇） | — | ✓ | ✓ | ✓ | ✓ |
| EB（苯甲酸酯） | ✓ | — | — | — | — |
| EV（戊酸酯） | ✓ | ✓ | ✓ | — | — |
| EC（环丙酸酯） | ✓ | — | — | — | — |
| EN（庚酸酯） | ✓ | — | — | — | — |
睾酮 (Testosterone)
| 化合物 | 注射 | 口服 | 凝胶 | 贴片 |
|---|---|---|---|---|
| T（睾酮） | — | — | ✓ | ✓ |
| TC（环丙酸酯） | ✓ | — | — | — |
| TE（庚酸酯） | ✓ | — | — | — |
| TU（十一酸酯） | ✓ | ✓ | — | — |
输出单位
- 雌二醇 pg/mL pmol/L
- 睾酮 ng/dL ng/mL nmol/L
迁移的交叉验证
本项目已进行模拟数据交叉验证实验，本项目运行结果与源项目运行结果数值上一致
python ./test/cross_validate.py
许可
本项目遵守 MIT License
致谢
- PK算法及常数、算法应用 LaoZhong-Mihari/HRT-Recorder-PKcomponent-Test
- PK算法及常数 TransmtfTeam/Transmtf-HRT-Tracker
- 算法应用 mkx173/Featherline
- 算法应用 xunxunProjects/Oyama-s-HRT-Tracker
修正联系
若对项目中的药代动力学算法部分有任何问题或建议，请提出 issue 或联系学术通讯邮箱 [email protected]
严重警告
本项目以教育目的开发，仅建议用于药代动力学模型研究、算法验证、数据分析方面
本项目输出的血药浓度结果来自数学模型拟合与理论参数计算，不等同于真实个体的血药浓度检测结果，不能替代临床实验室检测、药代动力学研究或医学专业评估
不建议将本项目用于任何临床医学用途，包括但不限于：
- 指导使用者开始、停止、调整或改变激素治疗方案；
- 决定雌二醇、睾酮或其他性激素药物的剂量；
- 判断药物治疗是否安全、有效或达到治疗目标；
- 替代医生进行处方、诊疗或医学决策；
